selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

LinkWarden logo

Self-host LinkWarden

v2.17.0

Collaborative bookmark manager with full-page archiving

ReleaseOpen SourceAGPL-3.0
Docker ComposeCompose file & guide
docker compose up
Updated4 days ago
LanguageTypescript
Setup difficultyModerate
MobileNative app
ThemeDark mode
Stars
20 434
Port
3000 (Linkwarden web app (UI and API))
Requires
PostgreSQL
Docker
ghcr.io/linkwarden/linkwarden
Home screen listing saved links and collections

What is LinkWarden?

Linkwarden is a collaborative bookmark manager you can run on your own server, aimed at readers who want saved pages to stay available even after the original site changes or disappears. Rather than only keeping an address, the app fetches each entry server-side and stores several renditions of it — a full-page JPEG, a printed PDF, a self-contained HTML file and cleaned-up article text — and can hand the URL to the Wayback Machine as well. Bookmarks are sorted into collections, sub-collections and tags; a reader view lets you highlight passages and attach notes, and search reaches the whole library. Collections support multiple members with individual permission levels and can also be published as a public list. Other documented capabilities include RSS feed subscriptions, bookmark import from your browser via Floccus, page uploads from SingleFile, image and PDF uploads, bulk editing, user administration, token-based API access and single sign-on through OIDC providers. Self-hosting follows a Docker Compose guide that also starts PostgreSQL and Meilisearch, with a manual Node.js route for more technical setups; containers exist for x86-64 and ARM64 and the app serves on port 3000. Development is open source under AGPL-3.0, with a hosted Cloud plan priced per user per month as the paid option.

LinkWarden alternatives

All self-hosted alternatives to Pinboard → All self-hosted alternatives to Pocket → All self-hosted alternatives to Raindrop →

Should you self-host LinkWarden?

LinkWarden scores 79/100 on selfhost.directory (how scoring works) and ranks #2 of 46 in Bookmarks & Link Sharing. It has 20 434 GitHub stars, +375 in the last 30 days.

It shipped 13 stable releases in the past year. The latest, v2.17.0, came out on 10 November 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Karakeep (81/100, 30 536 stars). It scores higher overall, so compare the two before you pick. See LinkWarden vs Karakeep side by side.

Features

  • AI auto-taggingOptional; needs Ollama or an OpenAI-compatible endpoint on self-hosted instances
  • Browser bookmark sync
  • Collaborative Collections
  • Collections and tags
  • Full-page archiving
  • Full-text search and filteringAdvanced search operators rely on Meilisearch
  • Public Sharing
  • Reader view with highlights and annotations
  • Wayback Machine snapshotsOptional

LinkWarden README

Linkwarden

Bookmarks, Evolved

linkwarden%2Flinkwarden | Trendshift

Discord Twitter

GitHub release Crowdin Open Collective

Intro & motivation

Linkwarden is a self-hosted, open-source collaborative bookmark manager to collect, read, annotate, and fully preserve what matters, all in one place.

The objective is to organize useful webpages and articles you find across the web in one place, and since useful webpages can go away (see the inevitability of Link Rot), Linkwarden also saves a copy of each webpage as a Screenshot and PDF, ensuring accessibility even if the original content is no longer available.

How to install LinkWarden

Install LinkWarden with Docker Compose

Docker
Environment variables
NEXTAUTH_URL, NEXTAUTH_SECRET, POSTGRES_PASSWORD, MEILI_MASTER_KEY

Requirements:

  • Docker
  • Curl
  • Nano
1. Download the required files
mkdir linkwarden && cd linkwarden
curl -O https://raw.githubusercontent.com/linkwarden/linkwarden/refs/heads/main/docker-compose.yml
curl -L https://raw.githubusercontent.com/linkwarden/linkwarden/refs/heads/main/.env.sample -o ".env"
2. Configure the Environment Variables
nano .env

The required environment variables are:

NEXTAUTH_URL=http://localhost:3000/api/v1/auth
NEXTAUTH_SECRET=VERY_SENSITIVE_SECRET
MEILI_MASTER_KEY=VERY_SENSITIVE_MEILI_MASTER_KEY
POSTGRES_PASSWORD=CUSTOM_POSTGRES_PASSWORD
3. Run it!

In the main folder (where you created the .env file) simply run the following:

docker compose up

A manual installation from source is also documented (Git, Node 20+, Yarn, Postgres 16+, Monolith).

How to configure LinkWarden

  • DATABASE_URLPostgreSQL connection string used by Prisma and the web/worker apps. Required when using an external or manually managed database.
  • NEXTAUTH_URLhttp://localhost:3000/api/v1/authFull NextAuth base URL. It must include the /api/v1/auth suffix so authentication and OAuth callbacks resolve correctly.
  • NEXTAUTH_SECRETSecret used to sign sessions, JWTs, and preserved-content tokens. Set this to a long random value in every non-development deployment.
  • POSTGRES_PASSWORDPassword for the bundled PostgreSQL container in the default Docker Compose setup. Compose uses it to build the internal DATABASE_URL.
  • PAGINATION_TAKE_COUNT50Number of links or tags fetched per paginated request.

LinkWarden releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

How do I view the current number of seats in my subscription?

The seat count is shown on the Billing page, though the page may need a refresh right after adding or removing seats.

What happens to the links and collections owned by a user if they are removed from a seat?

Their saved links and collections are kept, and the user can subscribe on their own with the same account to get them back.

How do I view and manage my current subscription plan?

Open the Billing page in your account and click "Billing Portal" to reach the Stripe-managed portal, where you can change the plan, update the payment method and see billing history.

More in Bookmarks & Link Sharing

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…