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.
Door Simon Vasconcelos Lee
Gepubliceerd op 18 november 2026Leestijd: 14 minuten
wallabag/wallabag, MariaDB, Redis, en de webpoort gepubliceerd op 127.0.0.1 achter een reverse proxy met HTTPS.SYMFONY__ENV__SECRET in, en uw openbare adres in SYMFONY__ENV__DOMAIN_NAME; wijzig daarna het wachtwoord van het account wallabag, dat wallabag is.X-Forwarded-Proto: https: zo weet wallabag dat zijn bezoekers via HTTPS binnenkomen.compose.yaml, en werk daarna bij door de tag van de image te wijzigen en de migraties uit te voeren.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.
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 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:
memory_limit sinds zijn versie 2.6.16 standaard op 256 MB, en de variabele PHP_MEMORY_LIMIT past dat aan.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 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:
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:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1: het voorbeeld van de repository publiceert poort 80 van de container zonder adres, en Docker opent hem dan op alle adressen van de server. Lokaal gepubliceerd is hij alleen bereikbaar via de reverse proxy.MYSQL_ROOT_PASSWORD maakt de image de database en zijn gebruiker aan, en voert daarna wallabag:install uit, dat de tabellen en het account wallabag aanmaakt. De regel wallabag is ready! in het logboek markeert het einde.wallabag; de dienst db houdt haar.wallabag-db bevat de database, wallabag-images de afbeeldingen van de artikelen. Ook het voorbeeld in de installatiedocumentatie gebruikt benoemde volumes.redis.2.6.17, 2.6, 2 en latest. Met een volledig versienummer kiest u zelf wanneer elke update gebeurt.Om te controleren of de applicatie antwoordt, vraagt u de route op die de healthcheck van de image gebruikt:
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.
/var/www/wallabag/data/db/wallabag.sqlite; koppel in dat geval een volume aan /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, poort 5432, en POSTGRES_USER en POSTGRES_PASSWORD zodat de image de database aanmaakt. Versie 2.6.15 van de image corrigeert het eigenaarschap van de database met PostgreSQL 15 en hoger.POPULATE_DATABASE=False en initialiseer haar daarna eenmalig met docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. De README vraagt deze opdracht als nobody uit te voeren, zodat geen enkel bestand eigendom van root wordt.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:
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.
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.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag en wallabag.| Variabele | Standaardwaarde | Waarvoor ze dient |
|---|---|---|
SYMFONY__ENV__SECRET | Een openbare tekenreeks, voor alle instanties dezelfde | Voegt entropie toe aan de beveiligingsbewerkingen: de documentatie wil dat ze uniek is voor uw instantie |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | Het volledige adres van uw instantie, zonder schuine streep aan het eind |
SYMFONY__ENV__FOSUSER_REGISTRATION | false in de Docker-image | Opent of sluit de openbare registratie |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Stuurt bij elke registratie een bevestigingsmail |
SYMFONY__ENV__LOCALE | en | De standaardtaal van de instantie, zoals fr |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | De 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.
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.
X-Forwarded-Proto: de proxy moet hem sturen met de waarde https.Host: uw domeinnaam, zodat de doorverwijzingen van de applicatie ernaar wijzen.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:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
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:
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;
}
}
sudo nginx -t
sudo certbot --nginx
Controleer daarna dat SYMFONY__ENV__DOMAIN_NAME het adres met https:// bevat, hetzelfde als dat van uw proxy.
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.
| Hulpmiddel | Wat het doet | Wat het nodig heeft |
|---|---|---|
| Android-app | Synchroniseert uw artikellijsten en toont ze op uw telefoon | Het adres van de instantie, uw gebruikersnaam en uw wachtwoord; de app haalt zelf de gegevens voor zijn feeds op |
| iOS-app | Toont uw artikelen op iPhone en iPad | Het adres, een client-ID en een secret voor de API, uw gebruikersnaam en uw wachtwoord |
| Extensie wallabagger, voor Firefox en Chrome | Bewaart de geopende pagina, met haar tags, als favoriet of gearchiveerd | Het adres, een client-ID en een secret voor de API, uw gebruikersnaam en uw wachtwoord |
| Bookmarklet “bag it!” | Bewaart de geopende pagina vanuit de bladwijzerbalk | Niets: u sleept hem vanaf de pagina “Howto” |
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:
| Dienst | Het aan te leveren bestand |
|---|---|
| Pocket, CSV-export | De ZIP van de Pocket-export, uitgepakt: een CSV-bestand met een naam als part_000000.csv |
| Pocket, HTML-export | Het HTML-bestand van de oudere Pocket-export, zoals ril_export.html |
| Instapaper | De CSV van de instellingenpagina van Instapaper |
| Omnivore | De bestanden metadata_x_to_y.json uit de uitgepakte export, één voor één |
| Pinboard, Delicious | Hun JSON-export |
| Shaarli | Zijn HTML-export |
| Firefox, Chrome | De JSON-back-up van de bladwijzers van Firefox, of het bestand Bookmarks van Chrome |
| Readability, elCurator | Hun export |
| wallabag 1.x of 2.x | De 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.
Om te voorkomen dat een grote import de pagina ophoudt, geeft wallabag hem door aan Redis, dat de compose.yaml hierboven al voorziet:
1.pocket_csv; hij werkt de wachtrij af en blijft daarna luisteren tot u hem stopt.docker compose run --rm wallabag import pocket_csv
De andere types zijn pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox en chrome.
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:
- 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
@ wordt %40. Als een gecodeerd teken het opstarten tegenhoudt, stelt de documentatie voor het procentteken te verdubbelen: %%40.FROM_EMAIL is de afzender van alle e-mails van wallabag, TWOFACTOR_SENDER de afzender van de codes voor tweestapsverificatie. Gebruik een adres op uw domein van waaruit uw SMTP-server mag verzenden.:465 aan het eind van de regel.Maak de container daarna opnieuw aan met docker compose up -d, en test met een link “Forgot your password?” op de aanmeldpagina.
De back-uppagina van de documentatie noemt drie onderdelen: de instellingen, de database en de afbeeldingen. Met de Docker-image staat elk ervan hier:
| Onderdeel | Waar het staat | Hoe u het kopieert |
|---|---|---|
| De instellingen | Uw compose.yaml: de image bouwt er bij elke start parameters.yml uit op | Een kopie van het bestand, veilig bewaard, want het bevat uw geheimen |
| De database | Het volume wallabag-db | Een export met mariadb-dump |
| De afbeeldingen | Het volume wallabag-images, gekoppeld aan web/assets/images | Een archief van de map |
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.
Start op een nieuwe installatie de stack met dezelfde compose.yaml, en laad daarna de database en de afbeeldingen terug:
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.
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:
docker compose pull
docker compose up -d
docker compose exec --user nobody wallabag php bin/console doctrine:migrations:migrate --env=prod --no-interaction
var/import, en de release notes vragen de oude map web/uploads/import leeg te maken. In deze compose.yaml staat die map in de container: de container die uit de nieuwe image wordt aangemaakt, start zonder haar.make update, dat op instanties met 2.6.15 of ouder een alfaversie koos die die ochtend was gepubliceerd. Voor een vastgelopen Git-installatie geven de release notes de oplossing: git checkout 2.6.17 --force, daarna make update.make update, dat ook de migraties uitvoert en de cache leegt.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.
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.
| Onderwerp | Ons team | U |
|---|---|---|
| De server | Systeem- en beveiligingsupdates, ingrepen op de server inbegrepen | Het moment dat bij uw activiteit past |
| De monitoring | Server 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachten | Het lezen van de logboeken van uw instantie |
| wallabag | Proactief toezicht: fouten, vertragingen, database en schijfruimte opgespoord, correctie aangeraden | De installatie, de updates en de instellingen, die u toepast, zelf of via uw AI-assistent |
| De accounts en artikelen | De server die ze draagt, bewaakt en geback-upt | De gebruikers, de registraties, de API-clients en de imports |
| De back-ups | Elke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepen | De eigen exports van wallabag, en het verzoek om terug te zetten, wanneer u dat nodig hebt |
| De migratie | Uw huidige server gemigreerd, gratis | Het 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Laten we het over uw website hebben
Vertel ons in een paar woorden over uw project: wij nemen snel contact met u op.
Bedankt! Uw aanvraag is verzonden. We nemen spoedig contact met u op.
Liever per e-mail? Schrijf ons op support@simafri.com.