Linkwarden zelf hosten: je eigen Wayback Machine en bladwijzerbeheerder

Bladwijzers hebben een stille zwakte. Je slaat een pagina op, komt een jaar later terug, en de link is dood, doorgestuurd of herschreven tot iets onherkenbaars. Het web verrot, en je zorgvuldig samengestelde leeslijst verrot gewoon mee.

Dat is het probleem waarvoor Linkwarden is gebouwd, en het is de reden dat veel mensen ervoor kiezen om Linkwarden zelf te hosten in plaats van hun referentiebibliotheek aan een externe dienst toe te vertrouwen. Het is een open-source bladwijzerbeheerder die een volledige kopie van elke pagina die je opslaat bewaart: een screenshot, een PDF, een enkel HTML-bestand en een schone, leesbare versie, zodat de inhoud toegankelijk blijft, zelfs nadat het origineel offline gaat. Zie het als een privéversie van de Wayback Machine die je van begin tot eind zelf beheert, met collecties, tags, zoekfunctie en een paar AI-trucs erbovenop.

Deze gids behandelt wat Linkwarden doet, wat je nodig hebt om het te draaien en hoe je het met Docker op je eigen server uitrolt. We zetten ook de onderdelen op die de meeste snelstartgidsen overslaan: full-text search, AI-tagging, back-ups en een reverse proxy zodat je het via een echt domein kunt bereiken.

Wat Linkwarden eigenlijk doet

In de kern is Linkwarden een bladwijzerbeheerder. Je slaat een link op, zet die in een collectie en voegt wat tags toe. Wat Linkwarden onderscheidt, is behoud. Het team erachter heeft de hele app gebouwd rond de realiteit van linkrot, dus een bladwijzer opslaan betekent ook de pagina zelf opslaan.

Wanneer je een link toevoegt, haalt Linkwarden de pagina op en slaat het lokaal verschillende formaten op: een screenshot van de volledige pagina, een PDF, een enkel zelfstandig HTML-bestand en een uitgeklede leesweergave voor afleidingsvrij lezen. Als je liever ook op een openbaar archief leunt, kan het optioneel namens jou een momentopname naar de Wayback Machine van het Internet Archive sturen. Hoe dan ook houd je je eigen kopie.

Het "en meer" is waar het een vaste plek in een zelfgehoste stack verdient:

Collecties en geneste subcollecties, plus meerdere tags per link, voor het organiseren van een grote bibliotheek
Full-text search over alles wat je hebt opgeslagen, aangedreven door Meilisearch
Lokale AI-tagging die de inhoud van een pagina leest en automatisch tags voorstelt
RSS-abonnementen die nieuwe artikelen vanzelf in een collectie binnenhalen
Gedeelde collecties met rechten per lid, handig voor teamonderzoek
Leesweergave met tekstmarkering en annotatie
Chrome- en Firefox-extensies, een gedocumenteerde API en bulkimport of -export

Het zit dus ergens tussen een lees-het-later-app en een echt webarchief in, wat een handige combinatie is als je onderzoek doet, schrijft of gewoon een hekel hebt aan het verliezen van goede links.

Waarom je eigen instantie draaien

Linkwarden biedt een gehost cloudabonnement, en dat is een prima optie als je niets wilt beheren. Maar zelf hosten is om een paar redenen verstandig.

Je bent eigenaar van de data. Elke screenshot, PDF en HTML-opname staat op jouw opslag, niet die van iemand anders, wat belangrijk is als je gevoelig onderzoek, interne documentatie of iets anders archiveert waarvan je de toegang niet kunt missen. Er zijn ook geen kosten per gebruiker, dus teamleden toevoegen aan een zelfgehoste instantie verandert je rekening niet.

Privacy is de andere helft ervan. Een zelfgehoste Linkwarden-instantie praat alleen met de sites die je opslaat en, optioneel, een AI-provider die jij kiest. Niets over je leesgewoonten wordt met een derde partij gedeeld. Als gegevensprivacy een deel is van waarom je überhaupt zelf host, past het in eigen beheer houden van je bladwijzerarchief bij dat doel.

Wat je nodig hebt

De vereisten van Linkwarden zijn bescheiden. De ontwikkelaars hebben het getest op een server met 4 GB geheugen en het draaide soepel; het zwaarste moment is de eerste build, en daarna is het vrij licht. Dat gezegd hebbende, archivering levert echt werk op, aangezien elke opgeslagen link een headless browser opstart om de pagina vast te leggen, dus wat speelruimte helpt als je in bulk opslaat.

Voor een schone Docker-implementatie wil je:

Een Linux-server met root-toegang, idealiter 4 GB RAM of meer
Docker en Docker Compose geïnstalleerd
curl en een teksteditor zoals nano

Een kleine VPS draait een instantie voor één gebruiker zonder moeite. Als je van plan bent om veel te archiveren of het voor een team te draaien, maakt een abonnement met sterke CPU en NVMe-opslag het vastleggen merkbaar sneller, omdat het genereren van screenshots en PDF's schijf- en CPU-gebonden is. Je hebt ook volledige root-toegang nodig om Docker te installeren en de stack te beheren, wat de meeste shared hosting uitsluit.

Hoe je Linkwarden zelf host met Docker

De officiële Docker-opzet is de snelste route, en het project houdt die goed gedocumenteerd. Het Compose-bestand start drie services samen: Linkwarden zelf, een PostgreSQL-database en Meilisearch voor zoeken.

1. Download de compose- en omgevingsbestanden

SSH naar je server, maak dan een map aan en haal de twee bestanden binnen die je nodig hebt:

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. Stel je geheimen in

Open het .env-bestand:

nano .env

Je ziet zoiets als dit:

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

Je moet drie hiervan wijzigen in je eigen geheime waarden: NEXTAUTH_SECRET, MEILI_MASTER_KEY en POSTGRES_PASSWORD. Elk moet een andere lange, willekeurige reeks zijn. Een makkelijke manier om ze te genereren is:

openssl rand -base64 32

Voer dat drie keer uit en plak voor elk een verse waarde. Als een waarde speciale tekens bevat, zet die dan tussen enkele of dubbele aanhalingstekens.

Laat NEXTAUTH_URL voorlopig met rust als je lokaal test. Je verandert die pas zodra je de instantie achter een domein zet, wat we zo meteen behandelen.

3. Start de stack

Breng vanuit dezelfde map alles omhoog:

docker compose up -d

De eerste run haalt de images op en bouwt de app, dus geef het een paar minuten. Zodra alles klaar is, luistert Linkwarden op poort 3000.

4. Maak je account aan

Open http://your-server-ip:3000 in een browser en je belandt op het inlogscherm. Klik op Sign Up om de eerste gebruiker aan te maken, met een wachtwoord van minstens acht tekens. Het eerste account dat je maakt is van jou om te beheren; als dit een opzet voor één gebruiker is, wil je waarschijnlijk daarna open registratie uitschakelen in de instellingen zodat vreemden geen accounts op je instantie kunnen aanmaken.

Op dit punt heb je een werkende Linkwarden. Sla een link op en kijk hoe het automatisch de screenshot, PDF en leesbare weergave genereert.

Het achter een domein zetten

Je instantie via IP en poort bereiken is prima om te testen, maar voor dagelijks gebruik wil je een echte hostnaam met HTTPS. Draai een reverse proxy zoals Caddy, Nginx of Traefik voor Linkwarden, wijs die naar poort 3000 en handel TLS daar af.

Zodra dat op zijn plek staat, werk je NEXTAUTH_URL in je .env bij zodat die overeenkomt met je domein, bijvoorbeeld https://links.yourdomain.com/api/v1/auth, en herstart je met docker compose up -d. Als je hier nog geen domein voor hebt, kun je er een registreren en een A-record naar je server laten wijzen. De officiële reverse proxy-documentatie bevat voorbeeldconfiguraties voor de gangbare proxy's.

Zoeken en AI-tagging instellen

Zoeken werkt direct uit de doos omdat Meilisearch in het standaard Compose-bestand zit. Zolang je MEILI_MASTER_KEY is ingesteld, werkt full-text search over je opgeslagen pagina's gewoon, inclusief de pagina-inhoud die Linkwarden heeft vastgelegd, niet alleen titels en tags.

AI-tagging is optioneel en standaard uitgeschakeld. Als het is ingeschakeld, leest het de inhoud van een pagina en stelt het tags voor of past ze automatisch toe, wat veel handmatig sorteren bespaart zodra je bibliotheek groeit. Je stelt het in door een AI-provider te koppelen; Linkwarden ondersteunt gehoste opties zoals OpenAI en Anthropic, of een lokaal model via Ollama als je liever alles op je eigen hardware houdt. Het model lokaal draaien is de privacyvriendelijke keuze en past natuurlijk bij een zelfgehoste opzet. De gids voor AI-tagging loopt de omgevingsvariabelen voor elke provider door.

Je instantie back-uppen en bijwerken

Zelf hosten betekent dat je verantwoordelijk bent voor je eigen vangnet, en Linkwarden bewaart zijn data op twee plekken: de PostgreSQL-database en een data-volume met alle screenshots, PDF's en HTML-opnames. Een complete back-up heeft beide nodig.

Dump de database met een one-liner die je in een cron-taak kunt zetten:

docker exec -t linkwarden-postgres pg_dump -U postgres postgres | gzip > linkwarden_$(date +%F).sql.gz

Maak daarna een back-up van het Docker-volume dat de vastgelegde bestanden bevat, want de database alleen herstelt je archieven niet. Als je opnames groot worden, is het de moeite waard om vroeg een schema op te zetten waarmee je dat volume off-site kopieert. Draaien op infrastructuur met dagelijkse back-ups geeft je een tweede laag onder je eigen dumps, wat geruststellend is voor een archief dat je niet vanaf nul wilt opbouwen.

Bijwerken is eenvoudig. Haal vanuit je Linkwarden-map de nieuwste image op en maak de containers opnieuw aan:

docker compose pull
docker compose up -d

Bekijk de release notes vóór een grote versiesprong, maar kleine updates verlopen meestal pijnloos.

Conclusie

Linkwarden verandert een kwetsbare stapel bladwijzers in een duurzaam, doorzoekbaar archief dat je volledig beheert. Met Docker is het snel opgezet: haal twee bestanden op, stel drie geheimen in en start de stack. Vanaf daar maken zoeken, AI-tagging, een reverse proxy en een back-uproutine er iets van dat je jarenlang opgeslagen leeswerk kunt toevertrouwen.

Het belangrijkste dat zelf hosten van je vraagt, is een betrouwbare server met root-toegang en genoeg middelen om het archiveringswerk aan te kunnen, en dat is precies waar de juiste VPS het verschil maakt.

Bedankt voor het lezen! Als je op zoek bent naar een plek om het te hosten, biedt QDE hoogwaardige VPS-hosting in Nederland met NVMe-opslag, 10 Gbps-uplinks en volledige root-toegang, wat goed past bij een zelfgehoste archiveringsapp zoals Linkwarden.

Klaar om te beginnen of wil je advies over het juiste abonnement? Neem contact op met ons team en we helpen je de beste keuze voor je project te vinden.

Veelgestelde vragen over het zelf hosten van Linkwarden

Is Linkwarden gratis om zelf te hosten?

Ja. Linkwarden is open-source, en zelf hosten geeft je elke functie uit het cloudabonnement zonder licentiekosten. Je enige uitgaven zijn de server waarop het draait en, als je een gehoste AI-provider gebruikt, de gebruikskosten van die provider.

Hoeveel serverkracht heb ik nodig?

Een VPS met 4 GB RAM draait een persoonlijke instantie zonder moeite. De buildstap en het archiveren van pagina's op aanvraag zijn de zwaarste momenten, dus meer CPU en snelle NVMe-opslag versnellen het vastleggen van screenshots en PDF's als je veel links opslaat of het voor een team draait.

Is Linkwarden een echt alternatief voor de Wayback Machine?

Voor persoonlijk gebruik, ja. Het slaat volledige lokale kopieën op van elke pagina die je opslaat als screenshot, PDF, HTML-bestand en leesbare weergave, zodat je opnames het overleven, zelfs als de oorspronkelijke site verdwijnt. Het kan ook momentopnames naar de openbare Wayback Machine sturen, maar de lokale kopieën zijn hoe dan ook van jou.

Heb ik Meilisearch nodig om zoeken te laten werken?

De standaard Docker-opzet bevat Meilisearch, dus full-text search werkt zodra je de waarde MEILI_MASTER_KEY instelt. Als zoeken niets oplevert, controleer dan of de Meilisearch-container draait en de sleutel overeenkomt.

Kan ik de AI-tagging volledig privé houden?

Ja. Wijs Linkwarden in plaats van een gehoste provider naar een lokaal model dat via Ollama op je eigen server draait. Pagina-inhoud verlaat je infrastructuur nooit, wat past bij een privacygerichte zelfgehoste opzet.

Hoe maak ik van alles een back-up?

Maak een back-up van zowel de PostgreSQL-database, met pg_dump, als het Docker-volume dat de vastgelegde screenshots, PDF's en HTML opslaat. De database alleen herstelt je gearchiveerde pagina's niet, dus je hebt beide nodig voor een volledig herstel.