wallabag auf einem Managed VPS zu hosten heißt, die Artikel, die Sie für später speichern, auf einer Maschine zu behalten, die Ihnen gehört und die unsere Teams aktuell halten und Tag und Nacht beaufsichtigen. wallabag ist eine freie, quelloffene Read-it-later-Anwendung unter der MIT-Lizenz. Dieser Leitfaden folgt der offiziellen Dokumentation und dem offiziellen Docker-Image in Version 2.6.17: die Installation mit Docker Compose, das erste Konto und die Geheimnisse, HTTPS, Apps und Browser-Erweiterungen, der Import aus Pocket und anderen Diensten, E-Mail, Backups und Updates.
Von Simon Vasconcelos Lee
Veröffentlicht am 18. November 2026Lesezeit: 14 Minuten
wallabag/wallabag, MariaDB, Redis und der Web-Port, auf 127.0.0.1 veröffentlicht, hinter einem Reverse Proxy mit HTTPS.SYMFONY__ENV__SECRET und Ihre öffentliche Adresse in SYMFONY__ENV__DOMAIN_NAME; ändern Sie danach das Passwort des Kontos wallabag, das wallabag lautet.X-Forwarded-Proto: https: Daran erkennt wallabag, dass seine Besucher über HTTPS kommen.compose.yaml, und aktualisieren Sie dann, indem Sie das Image-Tag ändern und die Migrationen ausführen.wallabag ist eine Read-it-later-Webanwendung: Sie speichern eine Seite mit einem Klick und lesen sie, wenn Sie Zeit haben. Sein README fasst es so zusammen: klicken, speichern, lesen, wann Sie wollen. wallabag zieht den Inhalt des Artikels heraus, sodass Sie die Pop-ups der ursprünglichen Seite nicht ablenken.
wallabag wird unter der MIT-Lizenz veröffentlicht, Copyright Nicolas Lœuillet seit 2013. Sie gewährt kostenlos das Recht, Kopien der Software zu nutzen, zu kopieren, zu ändern, zusammenzuführen, zu veröffentlichen, zu verbreiten, unterzulizenzieren und zu verkaufen. Sie können sie also für sich, Ihr Team oder Ihre Kunden betreiben, ohne eine Lizenz zu kaufen.
Die einzige Bedingung ist, den Urheberrechtshinweis und den Lizenztext in allen Kopien oder wesentlichen Teilen der Software beizubehalten. Der Text stellt die Software „wie besehen“ bereit, ohne Gewährleistung.
Die Dokumentation von wallabag nennt keinen Wert für Arbeitsspeicher oder Prozessor. Sie listet aber auf, was die Anwendung braucht, und das Docker-Image legt einige Werte fest, die bei der Bemessung helfen:
memory_limit seit seiner Version 2.6.16 standardmäßig auf 256 MB, und die Variable PHP_MEMORY_LIMIT ändert diesen Wert.Die Größe des Servers hängt also von der Zahl der Nutzer, der Menge an Artikeln und Ihren Importen ab. Auf einem Managed VPS beschreiben Sie uns Ihre Nutzung, und wir empfehlen Ihnen die passende Größe.
Das Repository wallabag/docker veröffentlicht das offizielle Image wallabag/wallabag auf Docker Hub und in der GitHub Container Registry, mit einer Beispieldatei für Compose: wallabag, eine MariaDB-Datenbank und Redis. Legen Sie auf einem Server mit Docker einen Ordner an und speichern Sie darin diese compose.yaml, die auf dem Beispiel aufbaut:
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:
Ersetzen Sie die drei geheimen Werte vor dem ersten Start. Hexadezimale Zeichenketten funktionieren überall, auch in den SQL-Befehlen, die das Image zum Anlegen der Datenbank schreibt:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1 veröffentlicht: Das Beispiel des Repositorys veröffentlicht den Port 80 des Containers ohne Adresse, und Docker öffnet ihn dann auf allen Adressen des Servers. Lokal veröffentlicht, ist er nur über den Reverse Proxy erreichbar.MYSQL_ROOT_PASSWORD legt das Image die Datenbank und ihren Nutzer an und führt dann wallabag:install aus, das die Tabellen und das Konto wallabag anlegt. Die Zeile wallabag is ready! im Protokoll markiert das Ende.wallabag; der Dienst db behält sie.wallabag-db enthält die Datenbank, wallabag-images die Artikelbilder. Auch das Beispiel der Installationsdokumentation verwendet benannte Volumes.redis.2.6.17, 2.6, 2 und latest. Mit einer vollständigen Versionsnummer bestimmen Sie selbst, wann jedes Update kommt.Um zu prüfen, ob die Anwendung antwortet, fragen Sie die Route ab, die der Healthcheck des Images verwendet:
curl http://127.0.0.1:8080/api/info
Das Image liest die Variablen SYMFONY__ENV__* bei jedem Start des Containers neu ein und leert den Cache. Nach einer Änderung der compose.yaml erstellt docker compose up -d den Container neu und übernimmt die neuen Einstellungen.
/var/www/wallabag/data/db/wallabag.sqlite; binden Sie in diesem Fall ein Volume auf /var/www/wallabag/data ein.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, Port 5432, sowie POSTGRES_USER und POSTGRES_PASSWORD, damit das Image die Datenbank anlegt. Version 2.6.15 des Images korrigiert die Eigentümerschaft der Datenbank mit PostgreSQL 15 und neuer.POPULATE_DATABASE=False und initialisieren Sie sie einmalig mit docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. Das README verlangt, diesen Befehl als nobody auszuführen, damit keine Dateien root gehören.Der Weg, den die Dokumentation auf einem eigenen Server empfiehlt, ist das Git-Repository mit seinem Makefile, mit Composer, dem Werkzeug make und den PHP-Erweiterungen von der Seite mit den Voraussetzungen:
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install
Der Webserver liefert dann den Ordner web aus, mit app.php als Einstiegspunkt: Die Seite zu den virtuellen Hosts gibt Konfigurationen für Nginx, Apache, Caddy und lighttpd an. Ihre Beispiele liefern wallabag an der Wurzel einer Domain oder Subdomain aus, die Einrichtung, die die Maintainer unterstützen.
Die Installation legt ein Administratorkonto an, dessen Benutzername und Passwort beide wallabag lauten, mit der Adresse wallabag@wallabag.io. Ändern Sie sie, bevor Sie die Instanz öffentlich zugänglich machen. Ein SSH-Tunnel holt den Port 8080 des Servers auf Ihren Computer, unter http://localhost:8080; ergänzen Sie -p und den SSH-Port, der in Ihrem Kundenbereich angegeben ist.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag und wallabag an.| Variable | Standardwert | Wozu sie dient |
|---|---|---|
SYMFONY__ENV__SECRET | Eine öffentliche Zeichenkette, für alle Instanzen gleich | Bringt Entropie in die Sicherheitsvorgänge: Die Dokumentation verlangt einen Wert, der nur Ihrer Instanz gehört |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | Die vollständige Adresse Ihrer Instanz, ohne Schrägstrich am Ende |
SYMFONY__ENV__FOSUSER_REGISTRATION | false im Docker-Image | Öffnet oder schließt die öffentliche Registrierung |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Sendet bei jeder Registrierung eine Bestätigungs-E-Mail |
SYMFONY__ENV__LOCALE | en | Die Standardsprache der Instanz, etwa fr |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | Der Name der Instanz, den Ihre Zwei-Faktor-App anzeigt |
Mit dem Docker-Image ist die öffentliche Registrierung also geschlossen. Um die Instanz Ihrem Team zu öffnen, legen Sie die Konten selbst unter „Users management“ an, oder öffnen Sie die Registrierung für die Zeit der Anmeldungen, mit Bestätigung per E-Mail.
Die heikleren Einstellungen liegen unter „Internal Settings“, dem Administrator der Instanz vorbehalten: das öffentliche Teilen von Artikeln, die Exportformate, die Anmeldung bei Seiten mit Bezahlschranke, das lokale Herunterladen von Bildern und die Importe im Hintergrund.
Der Container liefert wallabag über HTTP aus, auf seinem Port 80, über ein internes Nginx. HTTPS übernimmt der vorgeschaltete Reverse Proxy. Dieses interne Nginx liest den Header X-Forwarded-Proto: Lautet er https, teilt es PHP mit, dass die Anfrage verschlüsselt ist, und wallabag baut seine Links und Cookies entsprechend auf.
X-Forwarded-Proto: Der Proxy muss ihn mit dem Wert https senden.Host: Ihr Domainname, damit die Weiterleitungen der Anwendung darauf zeigen.Caddy bezieht das Zertifikat von Let’s Encrypt selbst und erneuert es. Seine Direktive reverse_proxy behält den Header Host bei und ergänzt standardmäßig X-Forwarded-For, X-Forwarded-Proto und X-Forwarded-Host:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
Dieser Block übernimmt die Header aus dem Nginx-Beispiel im README des Docker-Images, ergänzt den Header Host und die Upload-Grenze des Images und lauscht auf Port 80, damit Certbot HTTPS einrichten kann:
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
Prüfen Sie danach, dass SYMFONY__ENV__DOMAIN_NAME die Adresse mit https:// enthält, dieselbe wie die Ihres Proxys.
wallabag funktioniert im Browser, und das Projekt veröffentlicht außerdem Apps und eine Erweiterung, die sich über ihre Adresse, ohne Schrägstrich am Ende, mit Ihrer Instanz verbinden.
| Werkzeug | Was es tut | Was es braucht |
|---|---|---|
| Android-App | Synchronisiert Ihre Artikellisten und zeigt sie auf Ihrem Telefon an | Die Adresse der Instanz, Ihren Benutzernamen und Ihr Passwort; die App holt ihre Zugangsdaten für die Feeds selbst |
| iOS-App | Zeigt Ihre Artikel auf iPhone und iPad an | Die Adresse, eine Client-ID und ein Secret für die API, Ihren Benutzernamen und Ihr Passwort |
| Erweiterung wallabagger, für Firefox und Chrome | Speichert die geöffnete Seite, mit ihren Tags, als Favorit oder archiviert | Die Adresse, eine Client-ID und ein Secret für die API, Ihren Benutzernamen und Ihr Passwort |
| Bookmarklet „bag it!“ | Speichert die geöffnete Seite aus der Lesezeichenleiste | Nichts: Sie ziehen es von der Seite „Howto“ |
Das Menü „Import“ holt Ihre Artikel aus einem anderen Dienst. wallabag ruft den Inhalt jedes Artikels neu ab, was bei einem großen Export Zeit braucht. Die Importwerkzeuge der Version 2.6.17:
| Dienst | Die bereitzustellende Datei |
|---|---|
| Pocket, CSV-Export | Das ZIP des Pocket-Exports, entpackt: eine CSV-Datei mit einem Namen wie part_000000.csv |
| Pocket, HTML-Export | Die HTML-Datei des älteren Pocket-Exports, etwa ril_export.html |
| Instapaper | Die CSV-Datei von der Einstellungsseite von Instapaper |
| Omnivore | Die Dateien metadata_x_to_y.json aus dem entpackten Export, eine nach der anderen |
| Pinboard, Delicious | Ihr JSON-Export |
| Shaarli | Sein HTML-Export |
| Firefox, Chrome | Die JSON-Sicherung der Lesezeichen von Firefox oder die Datei Bookmarks von Chrome |
| Readability, elCurator | Ihr Export |
| wallabag 1.x oder 2.x | Der JSON-Export einer anderen Instanz |
Version 2.6.17 bringt außerdem eine Korrektur für den CSV-Import aus Pocket. Auch ein Import über die Pocket-API existiert, mit einem Entwicklerschlüssel, den der Administrator in der Konfiguration hinterlegt.
Damit ein großer Import die Seite nicht blockiert, übergibt wallabag ihn an Redis, das die compose.yaml oben bereits vorsieht:
1.pocket_csv; er arbeitet die Warteschlange ab und lauscht danach weiter, bis Sie ihn stoppen.docker compose run --rm wallabag import pocket_csv
Die anderen Arten sind pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox und chrome.
wallabag sendet E-Mails für die Bestätigung der Registrierung, das Zurücksetzen des Passworts und die Zwei-Faktor-Codes per E-Mail. Es versendet sie über den Server, den SYMFONY__ENV__MAILER_DSN beschreibt, standardmäßig smtp://127.0.0.1.
Konfigurieren Sie auf einem VPS von Simafri einen authentifizierten SMTP-Server, auf Port 587 oder 465: den E-Mail-Dienst Ihrer Domain oder einen Versanddienst. Die Dokumentation gibt das Format in einer Zeile an, mit Benutzer, Passwort, Server und Port:
- 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
@ wird %40. Wenn ein kodiertes Zeichen den Start verhindert, schlägt die Dokumentation vor, das Prozentzeichen zu verdoppeln: %%40.FROM_EMAIL ist der Absender aller E-Mails von wallabag, TWOFACTOR_SENDER der Absender der Zwei-Faktor-Codes. Verwenden Sie eine Adresse Ihrer Domain, von der Ihr SMTP-Server den Versand annimmt.:465 am Ende der Zeile.Erstellen Sie den Container danach mit docker compose up -d neu und testen Sie mit einem Link „Forgot your password?“ auf der Anmeldeseite.
Die Backup-Seite der Dokumentation nennt drei Elemente: die Einstellungen, die Datenbank und die Bilder. Mit dem Docker-Image liegt jedes davon hier:
| Element | Wo es liegt | Wie man es kopiert |
|---|---|---|
| Die Einstellungen | Ihre compose.yaml: Das Image erzeugt daraus bei jedem Start die parameters.yml | Eine Kopie der Datei, sicher aufbewahrt, da sie Ihre Geheimnisse enthält |
| Die Datenbank | Das Volume wallabag-db | Ein Export mit mariadb-dump |
| Die Bilder | Das Volume wallabag-images, eingebunden auf web/assets/images | Ein Archiv des Ordners |
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
Planen Sie diese Kopien regelmäßig ein und senden Sie sie außerhalb des Servers. Auf seiner Festplatte abgelegt, gehen diese Archive außerdem in seine nächtlichen Backups ein. Mit SQLite verlangt die Dokumentation, den Ordner data/db zu kopieren.
Starten Sie auf einer neuen Installation den Stack mit derselben compose.yaml und spielen Sie dann die Datenbank und die Bilder zurück:
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
Jeder Nutzer kann seine Artikel außerdem als JSON exportieren, aus der Liste „All entries“, und sie mit dem Importwerkzeug für wallabag 2.x in eine andere Instanz übernehmen. Für Administratoren exportiert der Befehl wallabag:export die Artikel eines Nutzers in eine Datei.
Ändern Sie mit Docker das Image-Tag in der compose.yaml, erstellen Sie ein Backup, laden Sie dann das neue Image und erstellen Sie den Container neu. Das README verlangt anschließend, die Migrationen der Datenbank auszuführen, wenn eine Version welche mitbringt:
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, und die Release Notes verlangen, den alten Ordner web/uploads/import zu leeren. In dieser compose.yaml liegt dieser Ordner im Container: Der aus dem neuen Image erstellte Container startet ohne ihn.make update, das auf Instanzen mit 2.6.15 oder älter eine am Morgen veröffentlichte Alpha-Version wählte. Für eine hängen gebliebene Git-Installation geben die Release Notes die Reparatur an: git checkout 2.6.17 --force, dann make update.make update, das auch die Migrationen ausführt und den Cache leert.Lesen Sie vor jedem Update die Release Notes der Version: Sie weisen auf die Schritte hin, die nur diese Version betreffen, wie den zu leerenden Ordner in 2.6.16.
Beim Selbsthosting müssen Sie neben der Anwendung auch den Server betreuen. Auf einem Managed VPS übernehmen unsere Teams den Server und betreuen Ihre Instanz proaktiv; wallabag bleibt Ihre Software, mit ihren Einstellungen und Ihren Artikeln.
| Thema | Unsere Teams | Sie |
|---|---|---|
| Der Server | System- und Sicherheitsupdates, Eingriffe am Server inbegriffen | Der Zeitpunkt, der zu Ihrem Betrieb passt |
| Die Überwachung | Server rund um die Uhr im Blick, mit Eingriff, ohne auf Ihren Anruf zu warten | Das Lesen der Protokolle Ihrer Instanz |
| wallabag | Proaktive Betreuung: Fehler, lange Antwortzeiten, Datenbank und Speicherplatz erkannt, Korrektur empfohlen | Installation, Updates und Einstellungen, die Sie umsetzen, selbst oder mit Ihrem KI-Assistenten |
| Die Konten und Artikel | Der Server, der sie trägt, überwacht und gesichert | Die Nutzer, die Registrierung, die API-Clients und die Importe |
| Die Backups | Jede Nacht, verschlüsselt und außerhalb der Maschine aufbewahrt; Wiederherstellung inbegriffen | Die eigenen Exporte von wallabag und die Wiederherstellungsanfrage, wenn Sie sie brauchen |
| Die Migration | Ihr aktueller Server wird kostenlos migriert | Der Zeitpunkt der Umstellung |
Wenn unsere Teams lieber in der Anwendung selbst eingreifen sollen, wird diese Leistung nach Stunden oder pauschal abgerechnet, mit einem Kostenvoranschlag vor dem Eingriff.
Mit einem Managed VPS von Simafri halten unsere Teams den Server Ihrer wallabag-Instanz aktuell, überwachen ihn Tag und Nacht und greifen ein, ohne auf Ihren Anruf zu warten; sie betreuen auch Ihre Instanz proaktiv und empfehlen Ihnen die sinnvollen Korrekturen, die Sie umsetzen, selbst oder mit Ihrem KI-Assistenten. Die Backups werden jede Nacht verschlüsselt und außerhalb der Maschine aufbewahrt, ihre Wiederherstellung ist inbegriffen, und die Migration Ihres aktuellen Servers ist kostenlos.
Ja. wallabag steht unter der MIT-Lizenz: Sie können es nutzen, ändern und weitergeben, im Unternehmen wie anderswo, ohne eine Lizenz zu kaufen, sofern Sie seinen Urheberrechtshinweis beibehalten. Bleiben die Kosten für den Server, auf dem es läuft.
Gehen Sie von der Beispiel-compose.yaml des Images wallabag/wallabag aus, mit MariaDB und Redis. Setzen Sie SYMFONY__ENV__SECRET, die Passwörter und Ihre Adresse in SYMFONY__ENV__DOMAIN_NAME, veröffentlichen Sie den Port auf 127.0.0.1, starten Sie dann docker compose up -d und schalten Sie einen Reverse Proxy mit HTTPS davor.
Die Installation legt einen Administrator an, dessen Benutzername und Passwort beide wallabag lauten. Ändern Sie das Passwort unter Config, Reiter Password, und die E-Mail-Adresse unter User information, bevor Sie die Instanz öffentlich zugänglich machen.
Entpacken Sie das ZIP des Pocket-Exports: Es enthält eine CSV-Datei wie part_000000.csv. Wählen Sie im Menü Import die Option Pocket CSV und laden Sie diese Datei hoch. wallabag ruft dann den Inhalt jedes Artikels ab; aktivieren Sie bei einem großen Export Redis in den internen Einstellungen.
Das Projekt veröffentlicht Apps für Android und iOS sowie die Erweiterung wallabagger für Firefox und Chrome, die sich über ihre Adresse, ohne Schrägstrich am Ende, mit Ihrer Instanz verbinden. iOS und wallabagger brauchen einen API-Client, den Sie unter API clients management anlegen.
Das Image liest den Header X-Forwarded-Proto, um zu erkennen, dass die Anfrage über HTTPS kommt. Lassen Sie Ihren Proxy ihn mit dem Wert https senden, zusammen mit dem Header Host Ihrer Domain, und tragen Sie die Adresse mit https:// in SYMFONY__ENV__DOMAIN_NAME ein.
Kopieren Sie drei Elemente: die Datenbank, mit mariadb-dump für MariaDB, das Volume mit den Bildern, eingebunden auf web/assets/images, und Ihre compose.yaml, die die Einstellungen und Geheimnisse enthält. Senden Sie diese Kopien außerhalb des Servers.
Ein Managed VPS deckt den Server ab: System, Sicherheit, Überwachung und Backups. Unsere Teams betreuen auch Ihre Instanz proaktiv und empfehlen Ihnen die sinnvollen Korrekturen, die Sie umsetzen. Ein Eingriff in der Anwendung wird nach Stunden oder pauschal abgerechnet.
Simafri
Sprechen wir über Ihr Vorhaben
Sagen Sie uns in wenigen Worten, was Sie brauchen: Wir melden uns schnell bei Ihnen.
Vielen Dank! Ihre Anfrage wurde gesendet. Wir melden uns in Kürze bei Ihnen.
Sie schreiben lieber eine E-Mail? Schreiben Sie uns an support@simafri.com.