Héberger wallabag sur un VPS géré, c'est garder les articles que vous mettez de côté pour plus tard sur une machine à vous, que nos équipes tiennent à jour et supervisent jour et nuit. wallabag est une application libre de lecture différée, sous licence MIT. Ce guide suit sa documentation officielle et son image Docker, à la version 2.6.17 : l'installation avec Docker Compose, le premier compte et les secrets, HTTPS, les applications et les extensions, l'import depuis Pocket et d'autres services, les e-mails, les sauvegardes et les mises à jour.
Par Simon Vasconcelos Lee
Publié le 18 novembre 2026Lecture : 15 minutes
wallabag/wallabag, MariaDB, Redis, et le port web publié sur 127.0.0.1 derrière un mandataire inverse en HTTPS.SYMFONY__ENV__SECRET et votre adresse publique dans SYMFONY__ENV__DOMAIN_NAME ; changez ensuite le mot de passe du compte wallabag, qui vaut wallabag.X-Forwarded-Proto: https : c'est ce qui fait savoir à wallabag que ses visiteurs arrivent en HTTPS.compose.yaml, puis mettez à jour en changeant l'étiquette de l'image et en lançant les migrations.wallabag est une application web de lecture différée : vous enregistrez une page en un clic, et vous la lisez quand vous avez le temps. Son README le résume ainsi : cliquer, enregistrer, lire quand vous voulez. wallabag extrait le contenu de l'article pour vous épargner les fenêtres et les sollicitations de la page d'origine.
wallabag est publié sous licence MIT, avec un copyright de Nicolas Lœuillet depuis 2013. Elle accorde gratuitement le droit d'utiliser, de copier, de modifier, de fusionner, de publier, de distribuer, de sous-licencier et de vendre des copies du logiciel. Vous pouvez donc le faire tourner pour vous, votre équipe ou vos clients, sans licence à acheter.
La seule condition est de garder la notice de copyright et le texte de la licence dans toute copie ou partie substantielle du logiciel. Le texte fournit le logiciel « tel quel », sans garantie.
La documentation de wallabag ne chiffre ni la mémoire ni le processeur. Elle donne en revanche ce que l'application demande, et l'image Docker fixe quelques valeurs utiles pour dimensionner :
memory_limit à 256 Mo par défaut depuis sa version 2.6.16, et la variable PHP_MEMORY_LIMIT la change.La taille du serveur dépend donc du nombre d'utilisateurs, du volume d'articles et de vos importations. Sur un VPS géré, décrivez-nous votre usage, et nous vous recommandons la taille qui convient.
Le dépôt wallabag/docker publie l'image officielle wallabag/wallabag sur Docker Hub et sur GitHub Container Registry, avec un fichier Compose d'exemple : wallabag, une base MariaDB et Redis. Sur un serveur où Docker est installé, créez un dossier et placez-y ce compose.yaml, qui reprend cet exemple :
services:
wallabag:
image: wallabag/wallabag:2.6.17
restart: unless-stopped
environment:
- MYSQL_ROOT_PASSWORD=mot-de-passe-root
- 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=mot-de-passe-base
- SYMFONY__ENV__DATABASE_CHARSET=utf8mb4
- SYMFONY__ENV__SECRET=chaine-secrete-aleatoire
- SYMFONY__ENV__DOMAIN_NAME=https://lire.example.com
- SYMFONY__ENV__MAILER_DSN=smtp://utilisateur:mot-de-passe@smtp.example.com:587
- SYMFONY__ENV__FROM_EMAIL=lire@example.com
- SYMFONY__ENV__TWOFACTOR_SENDER=lire@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=mot-de-passe-root
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:
Remplacez les trois valeurs secrètes avant le premier démarrage. Des chaînes hexadécimales conviennent partout, y compris dans les commandes SQL que l'image écrit pour créer la base :
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1 : l'exemple du dépôt publie le port 80 du conteneur sans adresse, et Docker l'ouvre alors sur toutes les adresses du serveur. Publié en local, il ne s'atteint que par le mandataire inverse.MYSQL_ROOT_PASSWORD, l'image crée la base et son utilisateur, puis lance wallabag:install, qui crée les tables et le compte wallabag. La ligne wallabag is ready! du journal annonce la fin.wallabag ; le service db la garde.wallabag-db garde la base, wallabag-images les images des articles. L'exemple de la documentation d'installation utilise lui aussi des volumes nommés.redis.2.6.17, 2.6, 2 et latest. Une version complète vous laisse choisir le moment de chaque mise à jour.Pour vérifier que l'application répond, interrogez la route que le contrôle de santé de l'image utilise :
curl http://127.0.0.1:8080/api/info
L'image relit les variables SYMFONY__ENV__* à chaque démarrage du conteneur et vide le cache. Après une modification du compose.yaml, un docker compose up -d recrée le conteneur et applique les nouveaux réglages.
/var/www/wallabag/data/db/wallabag.sqlite ; montez alors un volume sur /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, le port 5432, et POSTGRES_USER et POSTGRES_PASSWORD pour que l'image crée la base. La version 2.6.15 de l'image corrige la propriété de la base avec PostgreSQL 15 et au-delà.POPULATE_DATABASE=False, puis initialisez-la une seule fois avec docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. Le README demande de lancer cette commande avec le compte nobody, pour ne pas créer de fichiers appartenant à root.La voie que la documentation recommande sur un serveur dédié est le dépôt Git et son Makefile, avec Composer, l'outil make et les extensions PHP de la page des prérequis :
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install
Le serveur web sert ensuite le dossier web, avec app.php comme point d'entrée : la page des hôtes virtuels donne les configurations Nginx, Apache, Caddy et lighttpd. Ses exemples servent wallabag à la racine d'un domaine ou d'un sous-domaine, la configuration que les mainteneurs prennent en charge.
L'installation crée un compte administrateur dont l'identifiant et le mot de passe valent tous deux wallabag, avec l'adresse wallabag@wallabag.io. Changez-les avant d'ouvrir l'instance au public. Un tunnel SSH fait apparaître le port 8080 du serveur sur votre poste, à l'adresse http://localhost:8080 ; ajoutez -p et le port SSH affiché dans votre espace client.
ssh -L 8080:127.0.0.1:8080 utilisateur@lire.example.com
wallabag et wallabag.| Variable | Valeur par défaut | Son rôle |
|---|---|---|
SYMFONY__ENV__SECRET | Une chaîne publique, la même pour toutes les instances | Ajoute de l'entropie aux opérations de sécurité : la documentation la veut propre à votre instance |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | L'adresse complète de votre instance, sans barre oblique finale |
SYMFONY__ENV__FOSUSER_REGISTRATION | false dans l'image Docker | Ouvre ou ferme l'inscription publique |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Envoie un e-mail de confirmation à chaque inscription |
SYMFONY__ENV__LOCALE | en | La langue par défaut de l'instance, fr par exemple |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | Le nom de l'instance affiché dans votre application de double authentification |
Les inscriptions publiques sont donc fermées avec l'image Docker. Pour ouvrir l'instance à votre équipe, créez les comptes vous-même depuis « Gestion des utilisateurs », ou ouvrez les inscriptions le temps de les recevoir, avec la confirmation par e-mail.
Les réglages plus sensibles se trouvent dans « Configuration interne », réservés à l'administrateur de l'instance : partage public des articles, formats d'export, authentification sur les sites à abonnement, téléchargement local des images et importations en tâche de fond.
Le conteneur sert wallabag en HTTP, sur son port 80, par un Nginx interne. HTTPS se règle sur le mandataire inverse placé devant. Ce Nginx interne lit l'en-tête X-Forwarded-Proto : s'il vaut https, il signale à PHP que la requête est chiffrée, et wallabag construit ses liens et ses cookies en conséquence.
X-Forwarded-Proto : le mandataire doit le transmettre avec la valeur https.Host : le nom de votre domaine, pour que les redirections de l'application pointent vers lui.Caddy obtient lui-même le certificat Let's Encrypt et le renouvelle. Sa directive reverse_proxy garde l'en-tête Host et ajoute par défaut X-Forwarded-For, X-Forwarded-Proto et X-Forwarded-Host :
lire.example.com {
reverse_proxy 127.0.0.1:8080
}
Ce bloc reprend les en-têtes de l'exemple Nginx du README de l'image Docker, ajoute l'en-tête Host et la limite d'envoi de l'image, et écoute sur le port 80 pour laisser Certbot installer HTTPS :
server {
listen 80;
listen [::]:80;
server_name lire.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
Vérifiez ensuite que SYMFONY__ENV__DOMAIN_NAME porte bien l'adresse en https://, la même que celle de votre mandataire.
wallabag se lit dans le navigateur, et le projet publie aussi des applications et une extension, qui se connectent à votre instance par son adresse, sans barre oblique finale.
| Outil | Ce qu'il fait | Ce qu'il demande |
|---|---|---|
| Application Android | Synchronise vos listes d'articles et les affiche sur le téléphone | L'adresse de l'instance, votre identifiant et votre mot de passe ; l'application récupère seule ses accès aux flux |
| Application iOS | Affiche vos articles sur l'iPhone et l'iPad | L'adresse, un identifiant et un secret de client d'API, votre identifiant et votre mot de passe |
| Extension wallabagger, pour Firefox et Chrome | Enregistre la page ouverte, avec ses étiquettes, en favori ou archivée | L'adresse, un identifiant et un secret de client d'API, votre identifiant et votre mot de passe |
| Bookmarklet « bag it! » | Enregistre la page ouverte depuis la barre de favoris | Rien : il se glisse depuis la page « Aide » |
Le menu « Importer » reprend vos articles d'un autre service. wallabag récupère à nouveau le contenu de chaque article, ce qui prend du temps sur un gros export. Les imports de la version 2.6.17 :
| Service | Le fichier à fournir |
|---|---|
| Pocket, export CSV | Le ZIP d'export de Pocket, une fois décompressé : un fichier CSV nommé comme part_000000.csv |
| Pocket, export HTML | Le fichier HTML de l'ancien export de Pocket, comme ril_export.html |
| Instapaper | Le CSV de la page de réglages d'Instapaper |
| Omnivore | Les fichiers metadata_x_to_y.json de l'export décompressé, un par un |
| Pinboard, Delicious | Leur export JSON |
| Shaarli | Son export HTML |
| Firefox, Chrome | La sauvegarde JSON des marque-pages de Firefox, ou le fichier Bookmarks de Chrome |
| Readability, elCurator | Leur export |
| wallabag 1.x ou 2.x | L'export JSON d'une autre instance |
La version 2.6.17 apporte d'ailleurs une correction à l'import CSV de Pocket. L'import par l'API de Pocket existe aussi, avec une clé de développeur que l'administrateur déclare dans la configuration.
Pour qu'un gros import ne bloque pas la page, wallabag le confie à Redis, que le compose.yaml ci-dessus fournit déjà :
1.pocket_csv ; il traite la file, puis reste à l'écoute jusqu'à ce que vous l'arrêtiez.docker compose run --rm wallabag import pocket_csv
Les autres types sont pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox et chrome.
wallabag envoie des e-mails pour la confirmation des inscriptions, la réinitialisation des mots de passe et les codes de double authentification par e-mail. Il les envoie par le serveur que décrit SYMFONY__ENV__MAILER_DSN, qui vaut smtp://127.0.0.1 par défaut.
Sur un VPS Simafri, configurez un serveur SMTP authentifié, sur le port 587 ou 465 : celui de la messagerie de votre domaine, ou d'un service d'envoi. La documentation donne le format d'une seule ligne, utilisateur, mot de passe, serveur et port :
- SYMFONY__ENV__MAILER_DSN=smtp://lire%40example.com:mot-de-passe@smtp.example.com:587
- SYMFONY__ENV__FROM_EMAIL=lire@example.com
- SYMFONY__ENV__TWOFACTOR_SENDER=lire@example.com
@ devient %40. Si un caractère encodé empêche le démarrage, la documentation conseille de doubler le signe pour cent : %%40.FROM_EMAIL est l'expéditeur de tous les e-mails de wallabag, TWOFACTOR_SENDER celui des codes de double authentification. Prenez une adresse de votre domaine, que votre serveur SMTP accepte d'envoyer.:465 à la fin de la ligne.Recréez ensuite le conteneur avec docker compose up -d, puis testez avec un lien « Mot de passe oublié ? » depuis la page de connexion.
La page de sauvegarde de la documentation nomme trois éléments : les réglages, la base de données et les images. Avec l'image Docker, voici où chacun se trouve :
| Élément | Où il se trouve | Comment le copier |
|---|---|---|
| Les réglages | Votre compose.yaml : l'image en tire parameters.yml à chaque démarrage | Une copie du fichier, gardée à l'abri, car il porte vos secrets |
| La base de données | Le volume wallabag-db | Un export avec mariadb-dump |
| Les images | Le volume wallabag-images, monté sur web/assets/images | Une archive du dossier |
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
Planifiez ces copies et envoyez-les hors du serveur. Posées sur son disque, ces archives entrent aussi dans ses sauvegardes de nuit. Avec SQLite, la documentation demande de copier le dossier data/db.
Sur une nouvelle installation, démarrez la pile avec le même compose.yaml, puis rechargez la base et les images :
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
Chaque utilisateur peut aussi exporter ses articles en JSON, depuis la liste « Tous les articles », et les réimporter dans une autre instance par l'import wallabag 2.x. Côté administrateur, la commande wallabag:export exporte les articles d'un utilisateur dans un fichier.
Avec Docker, changez l'étiquette de l'image dans le compose.yaml, faites une sauvegarde, puis tirez la nouvelle image et recréez le conteneur. Le README demande ensuite de lancer les migrations de la base, quand une version en apporte :
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, et sa note demande de vider l'ancien dossier web/uploads/import. Dans ce compose.yaml, ce dossier vit dans le conteneur : celui qui naît de la nouvelle image part sans lui.make update, qui choisissait, sur les instances en 2.6.15 ou avant, une version alpha publiée le matin. Pour une installation par Git restée bloquée, sa note donne la réparation : git checkout 2.6.17 --force, puis make update.make update, qui applique aussi les migrations et vide le cache.Lisez la note de chaque version avant de mettre à jour : elle signale les gestes propres à la version, comme le dossier à vider de la 2.6.16.
L'auto-hébergement demande de tenir le serveur en plus de l'application. Sur un VPS géré, nos équipes prennent le serveur en main et suivent votre instance de manière proactive ; wallabag reste votre logiciel, avec ses réglages et vos articles.
| Sujet | Nos équipes | Vous |
|---|---|---|
| Le serveur | Mises à jour du système et de la sécurité, interventions sur le serveur comprises | Le moment qui convient à votre activité |
| La supervision | Serveur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appel | La lecture des journaux de votre instance |
| wallabag | Suivi proactif : erreurs, lenteurs, base de données et espace disque repérés, correction recommandée | Son installation, ses mises à jour et ses réglages, que vous appliquez, vous ou votre assistant IA |
| Les comptes et les articles | Le serveur qui les porte, surveillé et sauvegardé | Les utilisateurs, les inscriptions, les clients d'API et les importations |
| Les sauvegardes | Chaque nuit, chiffrées et gardées hors de la machine ; restauration comprise | Les exports propres à wallabag, et la demande de restauration, quand vous en avez besoin |
| La migration | Votre serveur actuel migré, offert | Le moment de la bascule |
Si vous préférez que nos équipes interviennent dans l'application elle-même, cette prestation se facture à l'heure ou au forfait, avec un chiffrage communiqué avant l'intervention.
Avec un VPS géré Simafri, nos équipes tiennent à jour le serveur de votre instance wallabag, le surveillent jour et nuit et interviennent sans attendre votre appel ; elles suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez, vous ou votre assistant IA. Les sauvegardes sont chiffrées chaque nuit et gardées hors de la machine, leur restauration est comprise, et la migration de votre serveur actuel est offerte.
Oui. wallabag est sous licence MIT : vous pouvez l'utiliser, le modifier et le redistribuer, en entreprise comme ailleurs, sans licence à acheter, en gardant sa notice de copyright. Reste le coût du serveur qui le fait tourner.
Reprenez le compose.yaml d'exemple de l'image wallabag/wallabag, avec MariaDB et Redis. Choisissez SYMFONY__ENV__SECRET, les mots de passe et votre adresse dans SYMFONY__ENV__DOMAIN_NAME, publiez le port sur 127.0.0.1, puis lancez docker compose up -d et placez un mandataire inverse en HTTPS devant.
L'installation crée un administrateur dont l'identifiant et le mot de passe valent tous deux wallabag. Changez le mot de passe dans Configuration, onglet Mot de passe, et l'adresse e-mail dans Mon compte, avant d'ouvrir l'instance au public.
Décompressez le ZIP d'export de Pocket : il contient un fichier CSV comme part_000000.csv. Dans le menu Importer, choisissez Pocket CSV et envoyez ce fichier. wallabag récupère ensuite le contenu de chaque article ; pour un gros export, activez Redis dans la configuration interne.
Le projet publie des applications Android et iOS et l'extension wallabagger pour Firefox et Chrome, qui se connectent à votre instance par son adresse, sans barre oblique finale. iOS et wallabagger demandent un client d'API, créé dans Gestion des clients API.
L'image lit l'en-tête X-Forwarded-Proto pour savoir que la requête est en HTTPS. Faites-le transmettre par votre mandataire avec la valeur https, avec l'en-tête Host de votre domaine, et mettez l'adresse en https:// dans SYMFONY__ENV__DOMAIN_NAME.
Copiez trois éléments : la base de données, avec mariadb-dump pour MariaDB, le volume des images monté sur web/assets/images, et votre compose.yaml, qui porte les réglages et les secrets. Envoyez ces copies hors du serveur.
Un VPS géré couvre le serveur : système, sécurité, supervision et sauvegardes. Nos équipes suivent aussi votre instance de manière proactive et vous recommandent les corrections utiles, que vous appliquez. Une intervention dans l'application se facture à l'heure ou au forfait.
Simafri
Parlons de votre site web
Dites-nous en deux mots votre projet : on revient vers vous rapidement.
Merci ! Votre demande a bien été envoyée. Nous vous répondrons rapidement.
Vous préférez l'email ? Écrivez-nous à support@simafri.com.