wallabag hosten op een Managed VPS: uw leeslijst op uw eigen server

wallabag hosten op een Managed VPS betekent dat de artikelen die u bewaart om later te lezen op een machine blijven die van u is, en die ons team bijwerkt en dag en nacht in de gaten houdt. wallabag is een vrije, open source read-it-later-applicatie onder de MIT-licentie. Deze gids volgt de officiële documentatie en de officiële Docker-image, in versie 2.6.17: de installatie met Docker Compose, het eerste account en de geheimen, HTTPS, de apps en browserextensies, het importeren uit Pocket en andere diensten, e-mail, back-ups en updates.

Simon Vasconcelos Lee Door Gepubliceerd op 18 november 2026Leestijd: 14 minuten

Alle gidsen

In het kort

  1. Dankzij de MIT-licentie gebruikt, wijzigt en verspreidt u wallabag vrij, in een bedrijf of elders, op voorwaarde dat u de copyrightvermelding behoudt.
  2. Installeer het met Docker Compose: de officiële image wallabag/wallabag, MariaDB, Redis, en de webpoort gepubliceerd op 127.0.0.1 achter een reverse proxy met HTTPS.
  3. Stel vóór de eerste start SYMFONY__ENV__SECRET in, en uw openbare adres in SYMFONY__ENV__DOMAIN_NAME; wijzig daarna het wachtwoord van het account wallabag, dat wallabag is.
  4. De reverse proxy stuurt X-Forwarded-Proto: https: zo weet wallabag dat zijn bezoekers via HTTPS binnenkomen.
  5. Maak een back-up van de database, het volume met de afbeeldingen en uw compose.yaml, en werk daarna bij door de tag van de image te wijzigen en de migraties uit te voeren.

Wat wallabag doet

wallabag is een read-it-later-webapplicatie: u bewaart een pagina met één klik en leest haar wanneer u tijd hebt. Zijn README vat het samen als klikken, bewaren, lezen wanneer u wilt. wallabag haalt de inhoud van het artikel eruit, zodat de pop-ups van de oorspronkelijke pagina u niet afleiden.

Wat de MIT-licentie toestaat

wallabag wordt gepubliceerd onder de MIT-licentie, copyright Nicolas Lœuillet sinds 2013. Die geeft u kosteloos het recht om kopieën van de software te gebruiken, te kopiëren, te wijzigen, samen te voegen, te publiceren, te verspreiden, in sublicentie te geven en te verkopen. U kunt hem dus draaien voor uzelf, uw team of uw klanten, zonder een licentie te kopen.

De enige voorwaarde is dat u de copyrightvermelding en de tekst van de licentie behoudt in alle kopieën of wezenlijke delen van de software. De tekst levert de software “zoals hij is”, zonder garantie.

De middelen waarmee u rekent

De documentatie van wallabag noemt geen cijfer voor geheugen of CPU. Ze somt wel op wat de applicatie nodig heeft, en de Docker-image legt enkele waarden vast die helpen bij de dimensionering:

De grootte van de server hangt dus af van het aantal gebruikers, het volume aan artikelen en uw imports. Op een managed VPS beschrijft u ons uw gebruik, en wij raden u de juiste grootte aan.

De installatie met Docker Compose

De repository wallabag/docker publiceert de officiële image wallabag/wallabag op Docker Hub en in de GitHub Container Registry, met een voorbeeldbestand voor Compose: wallabag, een MariaDB-database en Redis. Maak op een server met Docker een map aan en zet daarin deze compose.yaml, gebaseerd op dat voorbeeld:

compose.yaml
services:
  wallabag:
    image: wallabag/wallabag:2.6.17
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=root-password
      - SYMFONY__ENV__DATABASE_DRIVER=pdo_mysql
      - SYMFONY__ENV__DATABASE_HOST=db
      - SYMFONY__ENV__DATABASE_PORT=3306
      - SYMFONY__ENV__DATABASE_NAME=wallabag
      - SYMFONY__ENV__DATABASE_USER=wallabag
      - SYMFONY__ENV__DATABASE_PASSWORD=database-password
      - SYMFONY__ENV__DATABASE_CHARSET=utf8mb4
      - SYMFONY__ENV__SECRET=random-secret-string
      - SYMFONY__ENV__DOMAIN_NAME=https://read.example.com
      - SYMFONY__ENV__MAILER_DSN=smtp://user:password@smtp.example.com:587
      - SYMFONY__ENV__FROM_EMAIL=read@example.com
      - SYMFONY__ENV__TWOFACTOR_SENDER=read@example.com
    ports:
      - "127.0.0.1:8080:80"
    volumes:
      - wallabag-images:/var/www/wallabag/web/assets/images
    depends_on:
      - db
      - redis
  db:
    image: mariadb
    restart: unless-stopped
    environment:
      - MYSQL_ROOT_PASSWORD=root-password
    volumes:
      - wallabag-db:/var/lib/mysql
    healthcheck:
      test: ["CMD", "/usr/local/bin/healthcheck.sh", "--innodb_initialized"]
      interval: 20s
      timeout: 3s
  redis:
    image: redis:alpine
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 20s
      timeout: 3s

volumes:
  wallabag-images:
  wallabag-db:

Vervang de drie geheime waarden vóór de eerste start. Hexadecimale tekenreeksen werken overal, ook in de SQL-opdrachten die de image schrijft om de database aan te maken:

Terminal
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag

Om te controleren of de applicatie antwoordt, vraagt u de route op die de healthcheck van de image gebruikt:

Terminal
curl http://127.0.0.1:8080/api/info

De image leest de variabelen SYMFONY__ENV__* bij elke start van de container opnieuw in en leegt de cache. Na een wijziging van de compose.yaml maakt docker compose up -d de container opnieuw aan en past de nieuwe instellingen toe.

Met SQLite of PostgreSQL

Zonder Docker

De weg die de documentatie op een eigen server aanraadt, is de Git-repository met zijn Makefile, met Composer, het hulpmiddel make en de PHP-extensies van de pagina met vereisten:

Terminal
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install

De webserver serveert dan de map web, met app.php als toegangspunt: de pagina over virtuele hosts geeft configuraties voor Nginx, Apache, Caddy en lighttpd. De voorbeelden daar serveren wallabag aan de basis van een domein of subdomein, de opzet die de maintainers ondersteunen.

Het eerste account, de geheimen en de registraties

De installatie maakt een beheerdersaccount aan waarvan de gebruikersnaam en het wachtwoord allebei wallabag zijn, met het adres wallabag@wallabag.io. Wijzig ze voordat u de instantie voor het publiek openstelt. Een SSH-tunnel brengt poort 8080 van de server naar uw computer, op http://localhost:8080; voeg -p toe met de SSH-poort die in uw klantenzone staat.

Terminal, op uw computer
ssh -L 8080:127.0.0.1:8080 user@read.example.com
  1. Meld u aan met wallabag en wallabag.
  2. Kies in “Config”, tabblad “Password”, een nieuw wachtwoord van minstens 8 tekens.
  3. Vervang in het tabblad “User information” het e-mailadres door het uwe: daar komen de links om het wachtwoord opnieuw in te stellen.
  4. Schakel in hetzelfde tabblad tweestapsverificatie in. De documentatie raadt een app voor eenmalige codes aan, zoals FreeOTP, in plaats van de code per e-mail; wallabag biedt ook back-upcodes.
VariabeleStandaardwaardeWaarvoor ze dient
SYMFONY__ENV__SECRETEen openbare tekenreeks, voor alle instanties dezelfdeVoegt entropie toe aan de beveiligingsbewerkingen: de documentatie wil dat ze uniek is voor uw instantie
SYMFONY__ENV__DOMAIN_NAMEhttps://your-wallabag-instance.wallabag.orgHet volledige adres van uw instantie, zonder schuine streep aan het eind
SYMFONY__ENV__FOSUSER_REGISTRATIONfalse in de Docker-imageOpent of sluit de openbare registratie
SYMFONY__ENV__FOSUSER_CONFIRMATIONtrueStuurt bij elke registratie een bevestigingsmail
SYMFONY__ENV__LOCALEenDe standaardtaal van de instantie, zoals fr
SYMFONY__ENV__SERVER_NAMEYour wallabag instanceDe naam van de instantie die uw app voor tweestapsverificatie toont

Met de Docker-image is de openbare registratie dus gesloten. Om de instantie voor uw team open te stellen, maakt u de accounts zelf aan via “Users management”, of opent u de registratie zolang de aanmeldingen lopen, met bevestiging per e-mail.

De gevoeligere instellingen staan onder “Internal Settings”, voorbehouden aan de beheerder van de instantie: het openbaar delen van artikelen, de exportformaten, het aanmelden op sites met een betaalmuur, het lokaal downloaden van afbeeldingen en de imports op de achtergrond.

HTTPS: de reverse proxy

De container serveert wallabag via HTTP, op zijn poort 80, via een interne Nginx. HTTPS komt voor rekening van de reverse proxy die ervoor staat. Die interne Nginx leest de header X-Forwarded-Proto: staat die op https, dan meldt hij PHP dat het verzoek versleuteld is, en wallabag bouwt zijn links en cookies daarnaar op.

Met Caddy

Caddy haalt het certificaat van Let’s Encrypt zelf op en vernieuwt het. Zijn directive reverse_proxy behoudt de header Host en voegt standaard X-Forwarded-For, X-Forwarded-Proto en X-Forwarded-Host toe:

Caddyfile
read.example.com {
  reverse_proxy 127.0.0.1:8080
}

Met Nginx

Dit blok neemt de headers over uit het Nginx-voorbeeld in de README van de Docker-image, voegt de header Host en de uploadgrens van de image toe, en luistert op poort 80 zodat Certbot HTTPS kan instellen:

Nginx-blok
server {
    listen 80;
    listen [::]:80;
    server_name read.example.com;
    client_max_body_size 100M;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Host $server_name;
        proxy_set_header X-Forwarded-Proto https;
        proxy_set_header X-Forwarded-For $remote_addr;
    }
}
Terminal
sudo nginx -t
sudo certbot --nginx

Controleer daarna dat SYMFONY__ENV__DOMAIN_NAME het adres met https:// bevat, hetzelfde als dat van uw proxy.

Apps, browserextensies en RSS-feeds

wallabag werkt in de browser, en het project publiceert ook apps en een extensie, die verbinding maken met uw instantie via haar adres, zonder schuine streep aan het eind.

HulpmiddelWat het doetWat het nodig heeft
Android-appSynchroniseert uw artikellijsten en toont ze op uw telefoonHet adres van de instantie, uw gebruikersnaam en uw wachtwoord; de app haalt zelf de gegevens voor zijn feeds op
iOS-appToont uw artikelen op iPhone en iPadHet adres, een client-ID en een secret voor de API, uw gebruikersnaam en uw wachtwoord
Extensie wallabagger, voor Firefox en ChromeBewaart de geopende pagina, met haar tags, als favoriet of gearchiveerdHet adres, een client-ID en een secret voor de API, uw gebruikersnaam en uw wachtwoord
Bookmarklet “bag it!”Bewaart de geopende pagina vanuit de bladwijzerbalkNiets: u sleept hem vanaf de pagina “Howto”

Uw artikelen importeren uit Pocket en elders

Het menu “Import” haalt uw artikelen binnen uit een andere dienst. wallabag haalt de inhoud van elk artikel opnieuw op, wat bij een grote export tijd kost. De importfuncties van versie 2.6.17:

DienstHet aan te leveren bestand
Pocket, CSV-exportDe ZIP van de Pocket-export, uitgepakt: een CSV-bestand met een naam als part_000000.csv
Pocket, HTML-exportHet HTML-bestand van de oudere Pocket-export, zoals ril_export.html
InstapaperDe CSV van de instellingenpagina van Instapaper
OmnivoreDe bestanden metadata_x_to_y.json uit de uitgepakte export, één voor één
Pinboard, DeliciousHun JSON-export
ShaarliZijn HTML-export
Firefox, ChromeDe JSON-back-up van de bladwijzers van Firefox, of het bestand Bookmarks van Chrome
Readability, elCuratorHun export
wallabag 1.x of 2.xDe JSON-export van een andere instantie

Versie 2.6.17 brengt ook een correctie voor de CSV-import uit Pocket. Importeren via de Pocket-API bestaat ook, met een ontwikkelaarssleutel die de beheerder in de configuratie instelt.

Grote imports op de achtergrond

Om te voorkomen dat een grote import de pagina ophoudt, geeft wallabag hem door aan Redis, dat de compose.yaml hierboven al voorziet:

  1. Schakel in “Internal Settings”, sectie “Import”, Redis in met de waarde 1.
  2. Start de import vanuit het menu “Import”: wallabag zet de artikelen in een wachtrij.
  3. Start de worker voor het gekozen importtype, bijvoorbeeld pocket_csv; hij werkt de wachtrij af en blijft daarna luisteren tot u hem stopt.
Terminal, in de map van compose.yaml
docker compose run --rm wallabag import pocket_csv

De andere types zijn pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox en chrome.

E-mail: de SMTP-configuratie

wallabag verstuurt e-mails voor de bevestiging van registraties, het opnieuw instellen van wachtwoorden en de codes voor tweestapsverificatie per e-mail. Het verstuurt ze via de server die SYMFONY__ENV__MAILER_DSN beschrijft, standaard smtp://127.0.0.1.

Configureer op een VPS van Simafri een geauthenticeerde SMTP-server, op poort 587 of 465: de e-maildienst van uw domein, of een verzenddienst. De documentatie geeft het formaat op één regel, met gebruiker, wachtwoord, server en poort:

compose.yaml, dienst wallabag
      - SYMFONY__ENV__MAILER_DSN=smtp://read%40example.com:password@smtp.example.com:587
      - SYMFONY__ENV__FROM_EMAIL=read@example.com
      - SYMFONY__ENV__TWOFACTOR_SENDER=read@example.com

Maak de container daarna opnieuw aan met docker compose up -d, en test met een link “Forgot your password?” op de aanmeldpagina.

De back-ups

De back-uppagina van de documentatie noemt drie onderdelen: de instellingen, de database en de afbeeldingen. Met de Docker-image staat elk ervan hier:

OnderdeelWaar het staatHoe u het kopieert
De instellingenUw compose.yaml: de image bouwt er bij elke start parameters.yml uit opEen kopie van het bestand, veilig bewaard, want het bevat uw geheimen
De databaseHet volume wallabag-dbEen export met mariadb-dump
De afbeeldingenHet volume wallabag-images, gekoppeld aan web/assets/imagesEen archief van de map
Terminal, in de map van compose.yaml
docker compose exec -T db sh -c 'exec mariadb-dump -uroot -p"$MYSQL_ROOT_PASSWORD" wallabag' > wallabag-$(date +%F).sql
docker compose exec -T wallabag tar -czf - -C /var/www/wallabag/web/assets images > wallabag-images-$(date +%F).tar.gz
cp compose.yaml compose-$(date +%F).yaml

Plan deze kopieën in en stuur ze buiten de server. Op zijn schijf opgeslagen, gaan deze archieven ook mee in zijn nachtelijke back-ups. Met SQLite vraagt de documentatie de map data/db te kopiëren.

Terugzetten

Start op een nieuwe installatie de stack met dezelfde compose.yaml, en laad daarna de database en de afbeeldingen terug:

Terminal
docker compose exec -T db sh -c 'exec mariadb -uroot -p"$MYSQL_ROOT_PASSWORD" wallabag' < wallabag-2026-11-18.sql
docker compose exec -T wallabag tar -xzf - -C /var/www/wallabag/web/assets < wallabag-images-2026-11-18.tar.gz

Elke gebruiker kan zijn artikelen ook als JSON exporteren, vanuit de lijst “All entries”, en ze opnieuw importeren in een andere instantie met de importfunctie voor wallabag 2.x. Voor beheerders exporteert de opdracht wallabag:export de artikelen van een gebruiker naar een bestand.

De updates

Wijzig met Docker de tag van de image in de compose.yaml, maak een back-up, haal daarna de nieuwe image op en maak de container opnieuw aan. De README vraagt vervolgens de migraties van de database uit te voeren wanneer een versie die meebrengt:

Terminal, in de map van compose.yaml
docker compose pull
docker compose up -d
docker compose exec --user nobody wallabag php bin/console doctrine:migrations:migrate --env=prod --no-interaction

Lees de release notes van elke versie vóór het bijwerken: ze wijzen op de stappen die alleen voor die versie gelden, zoals de leeg te maken map in 2.6.16.

Wie doet wat op een managed VPS

Self-hosting vraagt dat u naast de applicatie ook de server beheert. Op een managed VPS neemt ons team de server voor zijn rekening en houdt het uw instantie proactief in de gaten; wallabag blijft uw software, met zijn instellingen en uw artikelen.

OnderwerpOns teamU
De serverSysteem- en beveiligingsupdates, ingrepen op de server inbegrepenHet moment dat bij uw activiteit past
De monitoringServer 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachtenHet lezen van de logboeken van uw instantie
wallabagProactief toezicht: fouten, vertragingen, database en schijfruimte opgespoord, correctie aangeradenDe installatie, de updates en de instellingen, die u toepast, zelf of via uw AI-assistent
De accounts en artikelenDe server die ze draagt, bewaakt en geback-uptDe gebruikers, de registraties, de API-clients en de imports
De back-upsElke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepenDe eigen exports van wallabag, en het verzoek om terug te zetten, wanneer u dat nodig hebt
De migratieUw huidige server gemigreerd, gratisHet moment van de overschakeling

Wilt u liever dat ons team in de applicatie zelf ingrijpt, dan wordt die dienstverlening per uur of tegen een vast bedrag gefactureerd, met een offerte voordat het werk begint.

wallabag, op een server die voor u wordt beheerd

Met een Managed VPS van Simafri houdt ons team de server van uw wallabag-instantie up-to-date, bewaakt hem dag en nacht en grijpt in zonder op uw oproep te wachten; het houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast, zelf of via uw AI-assistent. De back-ups worden elke nacht versleuteld en buiten de machine bewaard, het terugzetten is inbegrepen, en de migratie van uw huidige server is gratis.

Ontdek Managed VPS

Veelgestelde vragen

Is wallabag gratis?

Ja. wallabag valt onder de MIT-licentie: u kunt het gebruiken, wijzigen en verspreiden, in een bedrijf of elders, zonder een licentie te kopen, op voorwaarde dat u de copyrightvermelding behoudt. Wat overblijft, zijn de kosten van de server waarop het draait.

Hoe installeer ik wallabag met Docker Compose?

Vertrek van de voorbeeld-compose.yaml van de image wallabag/wallabag, met MariaDB en Redis. Stel SYMFONY__ENV__SECRET in, de wachtwoorden en uw adres in SYMFONY__ENV__DOMAIN_NAME, publiceer de poort op 127.0.0.1, start daarna docker compose up -d en zet er een reverse proxy met HTTPS voor.

Wat zijn de standaard inloggegevens van wallabag?

De installatie maakt een beheerder aan waarvan de gebruikersnaam en het wachtwoord allebei wallabag zijn. Wijzig het wachtwoord in Config, tabblad Password, en het e-mailadres in User information, voordat u de instantie voor het publiek openstelt.

Hoe importeer ik mijn Pocket-artikelen in wallabag?

Pak de ZIP van de Pocket-export uit: die bevat een CSV-bestand zoals part_000000.csv. Kies in het menu Import de optie Pocket CSV en upload dat bestand. wallabag haalt daarna de inhoud van elk artikel op; schakel voor een grote export Redis in de interne instellingen in.

Welke apps werken met wallabag?

Het project publiceert apps voor Android en iOS en de extensie wallabagger voor Firefox en Chrome, die verbinding maken met uw instantie via haar adres, zonder schuine streep aan het eind. iOS en wallabagger hebben een API-client nodig, aan te maken in API clients management.

Waarom blijven de links van wallabag op http achter een proxy?

De image leest de header X-Forwarded-Proto om te weten dat het verzoek via HTTPS loopt. Laat uw proxy hem sturen met de waarde https, samen met de header Host van uw domein, en zet het adres met https:// in SYMFONY__ENV__DOMAIN_NAME.

Hoe maak ik een back-up van wallabag?

Kopieer drie onderdelen: de database, met mariadb-dump voor MariaDB, het volume met de afbeeldingen dat aan web/assets/images is gekoppeld, en uw compose.yaml, die de instellingen en geheimen bevat. Stuur deze kopieën buiten de server.

Dekt een managed VPS ook wallabag?

Een managed VPS dekt de server: systeem, beveiliging, monitoring en back-ups. Ons team houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast. Een ingreep in de applicatie wordt per uur of tegen een vast bedrag gefactureerd.

Bronnen en officiële documentatie

Gerelateerde gidsen

FreshRSS hosten op een Managed VPS: uw RSS-feeds op uw eigen serverFreshRSS hosten op een Managed VPS betekent dat u en uw team uw RSS-feeds lezen vanaf een machine die van u is, en die ons team bijwerkt en dag en nacht in de gaten houdt. FreshRSS is vrije software onder de AGPL-3.0-licentie. Deze gids volgt de officiële documentatie: de installatie met Docker Compose, HTTPS, het verversen van de feeds, de accounts en het aanmelden, de API voor mobiele apps, de database, back-ups en updates.Back-ups van een VPS: wat u controleert voordat u tekentEen VPS-aanbod vermeldt bijna altijd “back-ups inbegrepen”. Achter die twee woorden kan een kopie zitten die elke nacht wordt gemaakt, buiten de machine wordt bewaard en door experts wordt teruggezet, of een snapshot op dezelfde schijf als de server. Deze gids geeft de vragen die het verschil maken, wat elk antwoord betekent, en de manier om te controleren dat een back-up terug te zetten is.Verschil tussen managed en unmanaged VPS: wie doet watHet verschil tussen een managed en een unmanaged VPS draait om één vraag: wie zorgt voor de server zodra hij draait. Toch heeft “managed” geen officiële definitie: van de ene hostingprovider tot de andere gaat het woord van een eenvoudige installatie van het systeem tot de volledige exploitatie van de server. Deze gids laat zien wie wat doet, regel voor regel, met het tussenniveau van ondersteuning, en geeft de vragen die de onduidelijkheid wegnemen voordat u tekent.
Neem contact op