🔗 Linkwarden — Bookmark Manager
Host: Homelab · Compose: Homelab/Docker/linkwarden/compose.yaml
Stack name: linkwarden
1. Overview
Linkwarden is a self-hosted bookmark manager with automatic page archiving (screenshots, PDF snapshots, Wayback Machine submissions). Meilisearch provides full-text search across saved bookmarks. Accessible publicly at links.m1ckyb.com via Cloudflare Tunnel.
2. Architecture & Services
| Service |
Image |
Port |
Role |
linkwarden |
linkwarden/linkwarden:v2.14.1 |
3500 |
Main application (bookmark manager + archiver) |
meilisearch |
getmeili/meilisearch:v1.12.8 |
— |
Full-text search engine |
postgres |
postgres:16-alpine |
— |
PostgreSQL database |
3. Networking
links — Internal bridge network connecting Linkwarden, Meilisearch, and Postgres.apps — External network for inter-stack integration.cloudflare-net — Routes public traffic to links.m1ckyb.com via Dockflare label.
4. Persistent Storage
| Container |
Host Path |
Description |
linkwarden |
/docker/data/linkwarden/data |
Archived snapshots and assets |
meilisearch |
/docker/data/linkwarden/meili_data |
Search index |
postgres |
/docker/data/linkwarden/pgdata |
PostgreSQL database |
5. Environment Variables
All loaded from .env:
| Variable |
Description |
NEXTAUTH_SECRET |
Random secret for NextAuth sessions |
NEXTAUTH_URL |
Public URL of the app |
DATABASE_URL |
PostgreSQL connection string |
NEXT_PUBLIC_DISABLE_REGISTRATION |
Lock down new signups |
MEILISEARCH_URL |
Internal Meilisearch URL |
MEILISEARCH_API_KEY |
Meilisearch admin API key |
MEILI_MASTER_KEY |
Master key for the Meilisearch container |
POSTGRES_PASSWORD / POSTGRES_DB / POSTGRES_USER |
Database credentials |
6. Access & Usage
| URL |
Description |
https://links.m1ckyb.com |
Linkwarden public UI |
http://localhost:3500 |
Direct local access |
docker compose -f Homelab/Docker/linkwarden/compose.yaml up -d
7. Maintenance & Backup
# Update
docker compose -f Homelab/Docker/linkwarden/compose.yaml pull
docker compose -f Homelab/Docker/linkwarden/compose.yaml up -d
# Backup
rsync -av /docker/data/linkwarden/ /backup/linkwarden/