Linkding — Minimal Self-Hosted Bookmark Manager

Introduction

Linkding is designed to be the simplest self-hosted bookmark manager that actually works. It focuses on fast tagging, search, and archiving without the bloat of heavier alternatives, making it a good fit for homelab setups with limited resources.

What Linkding Does

• Stores and organizes bookmarks with tags and descriptions
• Provides full-text search across bookmark titles, descriptions, URLs, and archived page content
• Automatically fetches page titles and descriptions when saving a URL
• Archives bookmarks as HTML snapshots using a background worker
• Supports multi-user mode with separate bookmark collections per user

Architecture Overview

Linkding is a Django application with a SQLite database by default (PostgreSQL optional). The frontend is server-rendered HTML with minimal JavaScript for a snappy experience. A background task scheduler (huey) handles asynchronous jobs like fetching metadata and creating HTML snapshots. The entire stack runs in a single Docker container.

Self-Hosting & Configuration

• Single Docker container with SQLite — no external database required
• Configure via environment variables: SUPERUSER credentials, timezone, base URL
• Switch to PostgreSQL by setting the LD_DB_ENGINE and connection variables
• Runs behind any reverse proxy; set LD_CSRF_TRUSTED_ORIGINS for HTTPS
• Supports OIDC/OAuth2 authentication for single sign-on

Key Features

• Minimal resource footprint — runs on a Raspberry Pi with under 50 MB RAM
• Browser extensions for Chrome, Firefox, and a bookmarklet for any browser
• REST API for programmatic access and third-party integrations
• Import and export in Netscape HTML format for portability
• Shared bookmarks and public profiles for collaborative use

Comparison with Similar Tools

• Shiori — Go-based bookmark manager with archiving, but fewer integrations and a less active community
• Wallabag — read-it-later app focused on article reading rather than bookmark management
• Raindrop.io — polished commercial service but not self-hosted
• Shaarli — PHP bookmark manager with a longer history but heavier setup
• Pinboard — paid cloud service with an archiving feature; Linkding offers similar features for free

FAQ

Q: Can I import bookmarks from my browser? A: Yes, export your browser bookmarks as an HTML file and import them through the Linkding settings page.

Q: Does Linkding support full-text search of archived pages? A: Yes, when archiving is enabled, the background worker snapshots page content and indexes it for search.

Q: How do I back up my bookmarks? A: Export via the UI or API in Netscape HTML format, or back up the SQLite database file directly.

Q: Can multiple users share the same instance? A: Yes, each user gets a separate bookmark collection with optional shared bookmark visibility.

Sources

• https://github.com/sissbruecker/linkding
• https://linkding.link