Why Linkwarden?

Bookmarks break. Websites change. Pages disappear. Linkwarden fixes this:

  • Auto-archiving — Full HTML copy of every saved page.
  • Screenshots — Visual preview of every bookmark.
  • Collections — Organize by project, topic, or team.
  • Tags — Flexible categorization.
  • Full-text search — Search inside archived page content.
  • Collaboration — Share collections with team members.
  • Browser extension — One-click save from any browser.

Prerequisites

  • Docker with docker-compose.
  • At least 512 MB RAM.

Step 1: Deploy with Docker Compose

# docker-compose.yml
version: "3"
services:
  linkwarden:
    image: ghcr.io/linkwarden/linkwarden:latest
    ports:
      - "3000:3000"
    environment:
      DATABASE_URL: postgresql://linkwarden:password@postgres:5432/linkwarden
      NEXTAUTH_SECRET: your-random-secret-string
      NEXTAUTH_URL: http://linkwarden.example.com
    volumes:
      - ./data:/data/data
    depends_on:
      - postgres
    restart: always

  postgres:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: linkwarden
      POSTGRES_PASSWORD: password
      POSTGRES_DB: linkwarden
    volumes:
      - ./pgdata:/var/lib/postgresql/data
    restart: always
docker compose up -d

Access at http://your-server:3000.


Step 2: Organizing Your Library

FeatureHow
CollectionsCreate folders by project/topic (e.g., “DevOps Tools”, “Research Papers”)
TagsAdd multiple tags per link for cross-cutting categorization
SearchFull-text search inside archived page content
FiltersFilter by collection, tag, date, or link status
ViewsCard view (with screenshots) or list view

Linkwarden vs Alternatives

FeatureLinkwardenRaindrop.ioPocketWallabag
Self-hostedYesNoNoYes
Auto-archiveFull HTMLNoSimplifiedFull HTML
ScreenshotsYesYesNoNo
CollaborationYesYes (paid)NoNo
Browser extensionYesYesYesYes
Full-text searchYesPaid onlyYesYes
CostFreeFree / $3/moFree / $5/moFree

Troubleshooting

ProblemSolution
Archiving fails for some sitesSite may block bots; check Linkwarden logs for details
Screenshots not generatingEnsure the container has enough RAM (min 512 MB)
Browser extension can’t connectVerify the server URL in extension settings; check CORS headers
Search returns no resultsArchiving must complete first; check the Jobs queue
Import from browser bookmarksUse Settings > Import > Upload HTML bookmark export

Summary

  • Archive every link with screenshots and full HTML copies.
  • Browser extension for one-click saving from Chrome/Firefox/Edge.
  • Collaboration via shared collections for teams.
  • Beats link rot — your saved content survives even when sites go down.