Héberger wallabag sur un VPS géré : vos articles à lire, sur votre serveur

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.

Simon Vasconcelos Lee Par Publié le 18 novembre 2026Lecture : 15 minutes

Tous les guides

L'essentiel

  1. La licence MIT permet d'utiliser, de modifier et de redistribuer wallabag librement, en entreprise comme ailleurs, en gardant sa notice de copyright.
  2. Installez-le avec Docker Compose : l'image officielle wallabag/wallabag, MariaDB, Redis, et le port web publié sur 127.0.0.1 derrière un mandataire inverse en HTTPS.
  3. Avant le premier démarrage, choisissez SYMFONY__ENV__SECRET et votre adresse publique dans SYMFONY__ENV__DOMAIN_NAME ; changez ensuite le mot de passe du compte wallabag, qui vaut wallabag.
  4. Le mandataire inverse transmet X-Forwarded-Proto: https : c'est ce qui fait savoir à wallabag que ses visiteurs arrivent en HTTPS.
  5. Sauvegardez la base, le volume des images et votre compose.yaml, puis mettez à jour en changeant l'étiquette de l'image et en lançant les migrations.

Ce que fait wallabag

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.

Ce que permet la licence MIT

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.

Les ressources à prévoir

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 :

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.

L'installation avec Docker Compose

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 :

compose.yaml
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 :

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

Pour vérifier que l'application répond, interrogez la route que le contrôle de santé de l'image utilise :

Terminal
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.

Avec SQLite ou PostgreSQL

Sans Docker

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 :

Terminal
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.

Le premier compte, les secrets et les inscriptions

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.

Terminal, sur votre poste
ssh -L 8080:127.0.0.1:8080 utilisateur@lire.example.com
  1. Connectez-vous avec wallabag et wallabag.
  2. Dans « Configuration », onglet « Mot de passe », choisissez un nouveau mot de passe, de 8 caractères au moins.
  3. Dans l'onglet « Mon compte », remplacez l'adresse e-mail par la vôtre : c'est elle qui reçoit les liens de réinitialisation du mot de passe.
  4. Dans le même onglet, activez la double authentification. La documentation recommande une application de codes à usage unique, comme FreeOTP, plutôt que le code envoyé par e-mail ; wallabag propose aussi des codes de secours.
VariableValeur par défautSon rôle
SYMFONY__ENV__SECRETUne chaîne publique, la même pour toutes les instancesAjoute de l'entropie aux opérations de sécurité : la documentation la veut propre à votre instance
SYMFONY__ENV__DOMAIN_NAMEhttps://your-wallabag-instance.wallabag.orgL'adresse complète de votre instance, sans barre oblique finale
SYMFONY__ENV__FOSUSER_REGISTRATIONfalse dans l'image DockerOuvre ou ferme l'inscription publique
SYMFONY__ENV__FOSUSER_CONFIRMATIONtrueEnvoie un e-mail de confirmation à chaque inscription
SYMFONY__ENV__LOCALEenLa langue par défaut de l'instance, fr par exemple
SYMFONY__ENV__SERVER_NAMEYour wallabag instanceLe 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.

HTTPS : le mandataire inverse

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.

Avec Caddy

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 :

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

Avec Nginx

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 :

Bloc Nginx
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;
    }
}
Terminal
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.

Les applications, les extensions et les flux RSS

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.

OutilCe qu'il faitCe qu'il demande
Application AndroidSynchronise vos listes d'articles et les affiche sur le téléphoneL'adresse de l'instance, votre identifiant et votre mot de passe ; l'application récupère seule ses accès aux flux
Application iOSAffiche vos articles sur l'iPhone et l'iPadL'adresse, un identifiant et un secret de client d'API, votre identifiant et votre mot de passe
Extension wallabagger, pour Firefox et ChromeEnregistre la page ouverte, avec ses étiquettes, en favori ou archivéeL'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 favorisRien : il se glisse depuis la page « Aide »

Importer vos articles depuis Pocket et ailleurs

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 :

ServiceLe fichier à fournir
Pocket, export CSVLe ZIP d'export de Pocket, une fois décompressé : un fichier CSV nommé comme part_000000.csv
Pocket, export HTMLLe fichier HTML de l'ancien export de Pocket, comme ril_export.html
InstapaperLe CSV de la page de réglages d'Instapaper
OmnivoreLes fichiers metadata_x_to_y.json de l'export décompressé, un par un
Pinboard, DeliciousLeur export JSON
ShaarliSon export HTML
Firefox, ChromeLa sauvegarde JSON des marque-pages de Firefox, ou le fichier Bookmarks de Chrome
Readability, elCuratorLeur export
wallabag 1.x ou 2.xL'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.

Les gros imports en tâche de fond

Pour qu'un gros import ne bloque pas la page, wallabag le confie à Redis, que le compose.yaml ci-dessus fournit déjà :

  1. Dans « Configuration interne », section « Import », activez Redis avec la valeur 1.
  2. Lancez l'import depuis le menu « Importer » : wallabag met les articles en file d'attente.
  3. Lancez le travailleur du type d'import choisi, par exemple pocket_csv ; il traite la file, puis reste à l'écoute jusqu'à ce que vous l'arrêtiez.
Terminal, dans le dossier du compose.yaml
docker compose run --rm wallabag import pocket_csv

Les autres types sont pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox et chrome.

Les e-mails : la configuration SMTP

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 :

compose.yaml, service wallabag
      - 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

Recréez ensuite le conteneur avec docker compose up -d, puis testez avec un lien « Mot de passe oublié ? » depuis la page de connexion.

Les sauvegardes

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émentOù il se trouveComment le copier
Les réglagesVotre compose.yaml : l'image en tire parameters.yml à chaque démarrageUne copie du fichier, gardée à l'abri, car il porte vos secrets
La base de donnéesLe volume wallabag-dbUn export avec mariadb-dump
Les imagesLe volume wallabag-images, monté sur web/assets/imagesUne archive du dossier
Terminal, dans le dossier du 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

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.

Restaurer

Sur une nouvelle installation, démarrez la pile avec le même compose.yaml, puis rechargez la base et les images :

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

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.

Les mises à jour

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 :

Terminal, dans le dossier du 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

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.

Qui fait quoi sur un VPS géré

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.

SujetNos équipesVous
Le serveurMises à jour du système et de la sécurité, interventions sur le serveur comprisesLe moment qui convient à votre activité
La supervisionServeur suivi 24 h/24 et 7 j/7, avec intervention sans attendre votre appelLa lecture des journaux de votre instance
wallabagSuivi proactif : erreurs, lenteurs, base de données et espace disque repérés, correction recommandéeSon installation, ses mises à jour et ses réglages, que vous appliquez, vous ou votre assistant IA
Les comptes et les articlesLe serveur qui les porte, surveillé et sauvegardéLes utilisateurs, les inscriptions, les clients d'API et les importations
Les sauvegardesChaque nuit, chiffrées et gardées hors de la machine ; restauration compriseLes exports propres à wallabag, et la demande de restauration, quand vous en avez besoin
La migrationVotre serveur actuel migré, offertLe 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.

wallabag, sur un serveur tenu pour vous

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.

Découvrir les VPS gérés

Questions fréquentes

wallabag est-il gratuit ?

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.

Comment installer wallabag avec Docker Compose ?

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.

Quels sont les identifiants par défaut de wallabag ?

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.

Comment importer ses articles Pocket dans wallabag ?

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.

Quelles applications fonctionnent avec wallabag ?

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.

Pourquoi les liens de wallabag restent-ils en http derrière un mandataire ?

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.

Comment sauvegarder wallabag ?

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-t-il wallabag ?

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.

Sources et documentation officielle

Guides liés

Héberger FreshRSS sur un VPS géré : vos flux RSS sur votre serveurHéberger FreshRSS sur un VPS géré, c'est lire vos flux RSS et ceux de votre équipe depuis une machine à vous, que nos équipes tiennent à jour et supervisent jour et nuit. FreshRSS est un logiciel libre sous licence AGPL-3.0. Ce guide suit sa documentation officielle : l'installation avec Docker Compose, HTTPS, l'actualisation des flux, les comptes et la connexion, l'API des applications mobiles, la base de données, les sauvegardes et les mises à jour.Sauvegardes d'un VPS : ce qu'il faut vérifier avant de signerUne offre de VPS annonce presque toujours « sauvegardes comprises ». Derrière ces deux mots, il peut y avoir une copie chaque nuit, gardée hors de la machine et restaurée par des experts, ou un instantané posé sur le même disque que le serveur. Ce guide donne les questions qui font la différence, ce que chaque réponse veut dire, et la façon de vérifier qu'une sauvegarde se restaure.Différence entre VPS géré et non géré : qui fait quoiLa différence entre un VPS géré et un VPS non géré tient à une question : qui s'occupe du serveur une fois qu'il tourne. Le mot « géré » n'a pourtant pas de définition officielle, et va d'un hébergeur à l'autre d'une simple installation du système à l'exploitation complète du serveur. Ce guide montre qui fait quoi, ligne par ligne, avec le niveau intermédiaire de l'assistance, et donne les questions qui lèvent l'ambiguïté avant de signer.
Contactez-nous