Att hosta wallabag på en Managed VPS innebär att artiklarna du sparar till senare stannar på en egen maskin, som våra team håller uppdaterad och bevakar dag och natt. wallabag är en fri applikation med öppen källkod för att läsa senare, under MIT-licensen. Den här guiden följer den officiella dokumentationen och den officiella Docker-avbilden i version 2.6.17: installation med Docker Compose, det första kontot och hemligheterna, HTTPS, appar och webbläsartillägg, import från Pocket och andra tjänster, e-post, säkerhetskopior och uppdateringar.
Av Simon Vasconcelos Lee
Publicerad den 18 november 2026Lästid: 14 minuter
wallabag/wallabag, MariaDB, Redis och webbporten publicerad på 127.0.0.1 bakom en omvänd proxy med HTTPS.SYMFONY__ENV__SECRET och din offentliga adress i SYMFONY__ENV__DOMAIN_NAME före första starten; byt sedan lösenordet för kontot wallabag, som är wallabag.X-Forwarded-Proto: https: så vet wallabag att besökarna kommer via HTTPS.compose.yaml, och uppdatera sedan genom att ändra avbildens tagg och köra migreringarna.wallabag är en webbapplikation för att läsa senare: du sparar en sida med ett klick och läser den när du har tid. Dess README sammanfattar det som klicka, spara, läs när du vill. wallabag plockar ut artikelns innehåll, så att du inte distraheras av den ursprungliga sidans popup-fönster.
wallabag publiceras under MIT-licensen, upphovsrätt Nicolas Lœuillet sedan 2013. Den ger kostnadsfritt rätten att använda, kopiera, ändra, slå samman, publicera, distribuera, underlicensiera och sälja kopior av programvaran. Du kan alltså köra den för dig själv, ditt team eller dina kunder, utan att köpa någon licens.
Det enda villkoret är att behålla upphovsrättsmeddelandet och licenstexten i alla kopior eller väsentliga delar av programvaran. Texten tillhandahåller programvaran ”i befintligt skick”, utan garanti.
Dokumentationen för wallabag anger ingen siffra för minne eller processor. Den listar däremot vad applikationen behöver, och Docker-avbilden fastställer några värden som hjälper vid dimensioneringen:
memory_limit till 256 MB som standard sedan sin version 2.6.16, och variabeln PHP_MEMORY_LIMIT ändrar det.Serverns storlek beror alltså på antalet användare, mängden artiklar och dina importer. På en Managed VPS beskriver du din användning för oss, och vi rekommenderar rätt storlek.
Förrådet wallabag/docker publicerar den officiella avbilden wallabag/wallabag på Docker Hub och GitHub Container Registry, med en exempelfil för Compose: wallabag, en MariaDB-databas och Redis. Skapa en mapp på en server med Docker och lägg denna compose.yaml i den, baserad på det exemplet:
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:
Ersätt de tre hemliga värdena före första starten. Hexadecimala strängar fungerar överallt, även i de SQL-kommandon som avbilden skriver för att skapa databasen:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1: förrådets exempel publicerar containerns port 80 utan adress, och Docker öppnar den då på alla serverns adresser. Publicerad lokalt nås den bara via den omvända proxyn.MYSQL_ROOT_PASSWORD skapar avbilden databasen och dess användare och kör sedan wallabag:install, som skapar tabellerna och kontot wallabag. Raden wallabag is ready! i loggen markerar slutet.wallabag; tjänsten db behåller den.wallabag-db rymmer databasen, wallabag-images artiklarnas bilder. Exemplet i installationsdokumentationen använder också namngivna volymer.redis.2.6.17, 2.6, 2 och latest. Med ett fullständigt versionsnummer väljer du själv när varje uppdatering sker.För att kontrollera att applikationen svarar kan du fråga den väg som avbildens hälsokontroll använder:
curl http://127.0.0.1:8080/api/info
Avbilden läser variablerna SYMFONY__ENV__* på nytt vid varje start av containern och tömmer cachen. När du har ändrat compose.yaml återskapar docker compose up -d containern och tillämpar de nya inställningarna.
/var/www/wallabag/data/db/wallabag.sqlite; montera i så fall en volym på /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, port 5432, samt POSTGRES_USER och POSTGRES_PASSWORD så att avbilden skapar databasen. Version 2.6.15 av avbilden rättar ägarskapet för databasen med PostgreSQL 15 och senare.POPULATE_DATABASE=False och initiera den sedan en gång med docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. README ber dig köra kommandot som nobody, så att inga filer hamnar i roots ägo.Det sätt som dokumentationen rekommenderar på en dedikerad server är Git-förrådet och dess Makefile, med Composer, verktyget make och PHP-tilläggen från sidan med krav:
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install
Webbservern serverar sedan mappen web, med app.php som ingångspunkt: sidan om virtuella värdar ger konfigurationer för Nginx, Apache, Caddy och lighttpd. Dess exempel serverar wallabag i roten av en domän eller underdomän, den uppsättning som förvaltarna stöder.
Installationen skapar ett administratörskonto vars användarnamn och lösenord båda är wallabag, med adressen wallabag@wallabag.io. Byt dem innan du öppnar instansen för allmänheten. En SSH-tunnel för serverns port 8080 till din dator, på http://localhost:8080; lägg till -p och den SSH-port som anges i ditt kundområde.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag och wallabag.| Variabel | Standardvärde | Vad den gör |
|---|---|---|
SYMFONY__ENV__SECRET | En offentlig sträng, densamma för alla instanser | Tillför entropi till säkerhetsåtgärderna: dokumentationen vill att den är unik för din instans |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | Den fullständiga adressen till din instans, utan snedstreck i slutet |
SYMFONY__ENV__FOSUSER_REGISTRATION | false i Docker-avbilden | Öppnar eller stänger den offentliga registreringen |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Skickar ett bekräftelsemejl vid varje registrering |
SYMFONY__ENV__LOCALE | en | Instansens standardspråk, som fr |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | Instansens namn som visas i din tvåfaktorsapp |
Med Docker-avbilden är den offentliga registreringen alltså stängd. För att öppna instansen för ditt team skapar du kontona själv under ”Users management”, eller öppnar registreringen medan personerna registrerar sig, med bekräftelse via e-post.
De känsligare inställningarna finns under ”Internal Settings”, förbehållna instansens administratör: offentlig delning av artiklar, exportformat, inloggning på webbplatser med betalvägg, lokal nedladdning av bilder och importer i bakgrunden.
Containern serverar wallabag över HTTP, på sin port 80, genom en intern Nginx. HTTPS sköts av den omvända proxyn framför den. Den interna Nginx läser huvudet X-Forwarded-Proto: när det är https talar den om för PHP att begäran är krypterad, och wallabag bygger sina länkar och kakor därefter.
X-Forwarded-Proto: proxyn måste skicka det med värdet https.Host: ditt domännamn, så att applikationens omdirigeringar pekar dit.Caddy hämtar själv certifikatet från Let’s Encrypt och förnyar det. Dess direktiv reverse_proxy behåller huvudet Host och lägger som standard till X-Forwarded-For, X-Forwarded-Proto och X-Forwarded-Host:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
Det här blocket använder huvudena från Nginx-exemplet i Docker-avbildens README, lägger till huvudet Host och avbildens uppladdningsgräns, och lyssnar på port 80 så att Certbot kan ställa in HTTPS:
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
Kontrollera sedan att SYMFONY__ENV__DOMAIN_NAME innehåller adressen med https://, samma som din proxys.
wallabag fungerar i webbläsaren, och projektet publicerar också appar och ett tillägg, som ansluter till din instans via dess adress, utan snedstreck i slutet.
| Verktyg | Vad det gör | Vad det behöver |
|---|---|---|
| Android-appen | Synkroniserar dina artikellistor och visar dem på din telefon | Instansens adress, ditt användarnamn och ditt lösenord; appen hämtar själv sina inloggningsuppgifter för flödena |
| iOS-appen | Visar dina artiklar på iPhone och iPad | Adressen, ett klient-id och en hemlighet för API:et, ditt användarnamn och ditt lösenord |
| Tillägget wallabagger, för Firefox och Chrome | Sparar den öppna sidan, med dess taggar, som favorit eller arkiverad | Adressen, ett klient-id och en hemlighet för API:et, ditt användarnamn och ditt lösenord |
| Bokmärkesverktyget ”bag it!” | Sparar den öppna sidan från bokmärkesfältet | Ingenting: du drar det från sidan ”Howto” |
Menyn ”Import” hämtar in dina artiklar från en annan tjänst. wallabag hämtar innehållet i varje artikel på nytt, vilket tar tid för en stor export. Importverktygen i version 2.6.17:
| Tjänst | Filen att lämna in |
|---|---|
| Pocket, CSV-export | Pockets export-ZIP, uppackad: en CSV-fil med ett namn som part_000000.csv |
| Pocket, HTML-export | HTML-filen från Pockets äldre export, som ril_export.html |
| Instapaper | CSV-filen från Instapapers inställningssida |
| Omnivore | Filerna metadata_x_to_y.json från den uppackade exporten, en i taget |
| Pinboard, Delicious | Deras JSON-export |
| Shaarli | Dess HTML-export |
| Firefox, Chrome | Firefox JSON-säkerhetskopia av bokmärken, eller Chromes fil Bookmarks |
| Readability, elCurator | Deras export |
| wallabag 1.x eller 2.x | JSON-exporten från en annan instans |
Version 2.6.17 innehåller också en rättelse av CSV-importen från Pocket. Import via Pockets API finns också, med en utvecklarnyckel som administratören anger i konfigurationen.
För att en stor import inte ska hålla upp sidan lämnar wallabag över den till Redis, som compose.yaml ovan redan tillhandahåller:
1.pocket_csv; den betar av kön och fortsätter sedan att lyssna tills du stoppar den.docker compose run --rm wallabag import pocket_csv
De andra typerna är pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox och chrome.
wallabag skickar e-post för bekräftelse av registrering, återställning av lösenord och tvåfaktorskoder via e-post. Det skickar dem genom den server som SYMFONY__ENV__MAILER_DSN beskriver, som standard smtp://127.0.0.1.
Konfigurera på en VPS från Simafri en autentiserad SMTP-server, på port 587 eller 465: din domäns e-posttjänst eller en utskickstjänst. Dokumentationen anger formatet på en rad, med användare, lösenord, server och 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
@ blir %40. Om ett kodat tecken stoppar starten föreslår dokumentationen att procenttecknet dubbleras: %%40.FROM_EMAIL är avsändaren för all e-post från wallabag, TWOFACTOR_SENDER avsändaren för tvåfaktorskoder. Använd en adress på din domän som din SMTP-server godtar att skicka från.:465 i slutet av raden.Återskapa sedan containern med docker compose up -d, och testa med en länk ”Forgot your password?” från inloggningssidan.
Dokumentationens sida om säkerhetskopior nämner tre delar: inställningarna, databasen och bilderna. Med Docker-avbilden ligger var och en här:
| Del | Var den finns | Hur du kopierar den |
|---|---|---|
| Inställningarna | Din compose.yaml: avbilden bygger parameters.yml utifrån den vid varje start | En kopia av filen, förvarad säkert, eftersom den innehåller dina hemligheter |
| Databasen | Volymen wallabag-db | En export med mariadb-dump |
| Bilderna | Volymen wallabag-images, monterad på web/assets/images | Ett arkiv av mappen |
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
Schemalägg dessa kopior och skicka dem bort från servern. Lagrade på dess disk ingår dessa arkiv också i dess nattliga säkerhetskopior. Med SQLite ber dokumentationen dig kopiera mappen data/db.
På en ny installation startar du stacken med samma compose.yaml och läser sedan in databasen och bilderna igen:
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
Varje användare kan också exportera sina artiklar som JSON, från listan ”All entries”, och importera dem igen i en annan instans med importverktyget för wallabag 2.x. För administratörer exporterar kommandot wallabag:export en användares artiklar till en fil.
Med Docker ändrar du avbildens tagg i compose.yaml, tar en säkerhetskopia, hämtar sedan den nya avbilden och återskapar containern. README ber dig därefter köra databasmigreringarna när en version har sådana med sig:
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, och versionsanteckningarna ber dig tömma den gamla mappen web/uploads/import. I denna compose.yaml ligger den mappen inne i containern: den som skapas från den nya avbilden startar utan den.make update, som på instanser med 2.6.15 eller äldre valde en alfaversion som publicerats samma morgon. För en Git-installation som fastnat anger versionsanteckningarna lösningen: git checkout 2.6.17 --force, sedan make update.make update, som också kör migreringarna och tömmer cachen.Läs versionsanteckningarna för varje version innan du uppdaterar: de pekar ut de steg som gäller just den versionen, som mappen att tömma i 2.6.16.
Att självhosta innebär att sköta servern utöver applikationen. På en Managed VPS tar våra team hand om servern och följer din instans proaktivt; wallabag förblir din programvara, med sina inställningar och dina artiklar.
| Område | Våra team | Du |
|---|---|---|
| Servern | Uppdateringar av system och säkerhet, ingrepp på servern inräknade | Tidpunkten som passar din verksamhet |
| Övervakningen | Servern följs dygnet runt, alla dagar, med ingrepp utan att vänta på ditt samtal | Läsningen av din instans loggar |
| wallabag | Proaktiv uppföljning: fel, långsamma svarstider, databas och diskutrymme upptäcks, med rekommenderad rättelse | Installationen, uppdateringarna och inställningarna, som du genomför själv eller med din AI-assistent |
| Kontona och artiklarna | Servern som bär dem, övervakad och säkerhetskopierad | Användarna, registreringen, API-klienterna och importerna |
| Säkerhetskopiorna | Varje natt, krypterade och förvarade utanför maskinen; återställning ingår | wallabags egna exporter och begäran om återställning, när du behöver den |
| Migreringen | Din nuvarande server migreras kostnadsfritt | Tidpunkten för bytet |
Om du föredrar att våra team ingriper i själva applikationen faktureras den tjänsten per timme eller som fast pris, med en offert som lämnas före ingreppet.
Med en Managed VPS från Simafri håller våra team servern för din wallabag-instans uppdaterad, övervakar den dag och natt och griper in utan att vänta på ditt samtal; de följer också din instans proaktivt och rekommenderar de rättelser som är till nytta, som du genomför själv eller med din AI-assistent. Säkerhetskopiorna krypteras varje natt och förvaras utanför maskinen, återställningen ingår, och migreringen av din nuvarande server är kostnadsfri.
Ja. wallabag omfattas av MIT-licensen: du kan använda, ändra och vidaredistribuera det, i företag som på andra håll, utan att köpa någon licens, så länge du behåller dess upphovsrättsmeddelande. Det som återstår är kostnaden för servern som kör det.
Utgå från exempelfilen compose.yaml för avbilden wallabag/wallabag, med MariaDB och Redis. Ange SYMFONY__ENV__SECRET, lösenorden och din adress i SYMFONY__ENV__DOMAIN_NAME, publicera porten på 127.0.0.1, kör sedan docker compose up -d och placera en omvänd proxy med HTTPS framför.
Installationen skapar en administratör vars användarnamn och lösenord båda är wallabag. Byt lösenordet under Config, fliken Password, och e-postadressen under User information, innan du öppnar instansen för allmänheten.
Packa upp Pockets export-ZIP: den innehåller en CSV-fil som part_000000.csv. Välj Pocket CSV i menyn Import och ladda upp den filen. wallabag hämtar sedan innehållet i varje artikel; vid en stor export aktiverar du Redis i de interna inställningarna.
Projektet publicerar appar för Android och iOS och tillägget wallabagger för Firefox och Chrome, som ansluter till din instans via dess adress, utan snedstreck i slutet. iOS och wallabagger behöver en API-klient, som skapas i API clients management.
Avbilden läser huvudet X-Forwarded-Proto för att veta att begäran går över HTTPS. Låt din proxy skicka det med värdet https, tillsammans med huvudet Host för din domän, och ange adressen med https:// i SYMFONY__ENV__DOMAIN_NAME.
Kopiera tre delar: databasen, med mariadb-dump för MariaDB, volymen med bilderna som är monterad på web/assets/images, och din compose.yaml, som innehåller inställningarna och hemligheterna. Skicka dessa kopior bort från servern.
En Managed VPS täcker servern: system, säkerhet, övervakning och säkerhetskopior. Våra team följer också din instans proaktivt och rekommenderar de rättelser som är till nytta, som du genomför själv. Ett ingrepp i själva applikationen faktureras per timme eller som fast pris.
Simafri
Låt oss prata om din webbplats
Berätta om ditt projekt med några ord: vi återkommer snabbt.
Tack! Din förfrågan har skickats. Vi återkommer till dig inom kort.
Föredrar du e-post? Skriv till oss på support@simafri.com.