At hoste wallabag på en Managed VPS betyder, at de artikler, du gemmer til senere, bliver på en maskine, der er din egen, og som vores teams holder opdateret og overvåger dag og nat. wallabag er en fri, open source read-it-later-applikation under MIT-licensen. Denne guide følger den officielle dokumentation og det officielle Docker-image i version 2.6.17: installation med Docker Compose, den første konto og hemmelighederne, HTTPS, apps og browserudvidelser, import fra Pocket og andre tjenester, e-mail, backup og opdateringer.
Af Simon Vasconcelos Lee
Udgivet den 18. november 2026Læsetid: 14 minutter
wallabag/wallabag, MariaDB, Redis og webporten publiceret på 127.0.0.1 bag en reverse proxy med HTTPS.SYMFONY__ENV__SECRET og din offentlige adresse i SYMFONY__ENV__DOMAIN_NAME før første start; skift derefter adgangskoden til kontoen wallabag, som er wallabag.X-Forwarded-Proto: https: sådan ved wallabag, at dets besøgende kommer via HTTPS.compose.yaml, og opdatér derefter ved at ændre imagets tag og køre migreringerne.wallabag er en read-it-later-webapplikation: du gemmer en side med ét klik og læser den, når du har tid. Dets README opsummerer det som klik, gem, læs, når du vil. wallabag trækker artiklens indhold ud, så pop-ups fra den oprindelige side ikke distraherer dig.
wallabag udgives under MIT-licensen, copyright Nicolas Lœuillet siden 2013. Den giver gratis ret til at bruge, kopiere, ændre, sammenflette, udgive, distribuere, underlicensere og sælge kopier af softwaren. Du kan altså køre den for dig selv, dit team eller dine kunder uden at købe en licens.
Den eneste betingelse er at beholde copyrightmeddelelsen og licensteksten i alle kopier eller væsentlige dele af softwaren. Teksten leverer softwaren «som den er», uden garanti.
Dokumentationen for wallabag sætter ikke tal på hukommelse eller CPU. Den lister dog, hvad applikationen har brug for, og Docker-imaget fastsætter nogle værdier, der hjælper med dimensioneringen:
memory_limit til 256 MB som standard siden sin version 2.6.16, og variablen PHP_MEMORY_LIMIT ændrer den.Serverens størrelse afhænger altså af antallet af brugere, mængden af artikler og dine importer. På en Managed VPS beskriver du din brug for os, og vi anbefaler dig den rette størrelse.
Repositoriet wallabag/docker udgiver det officielle image wallabag/wallabag på Docker Hub og GitHub Container Registry, med en eksempelfil til Compose: wallabag, en MariaDB-database og Redis. Opret en mappe på en server med Docker, og læg denne compose.yaml i den, bygget på det eksempel:
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:
Erstat de tre hemmelige værdier før første start. Hexadecimale strenge virker overalt, også i de SQL-kommandoer, som imaget skriver for at oprette databasen:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1: repositoriets eksempel publicerer containerens port 80 uden adresse, og Docker åbner den så på alle serverens adresser. Publiceret lokalt kan den kun nås gennem reverse proxyen.MYSQL_ROOT_PASSWORD opretter imaget databasen og dens bruger og kører derefter wallabag:install, som opretter tabellerne og kontoen wallabag. Linjen wallabag is ready! i loggen markerer afslutningen.wallabag; tjenesten db beholder den.wallabag-db rummer databasen, wallabag-images artiklernes billeder. Eksemplet i installationsdokumentationen bruger også navngivne volumener.redis.2.6.17, 2.6, 2 og latest. Med et fuldt versionsnummer vælger du selv, hvornår hver opdatering sker.For at kontrollere, at applikationen svarer, kan du spørge på den rute, som imagets healthcheck bruger:
curl http://127.0.0.1:8080/api/info
Imaget læser variablerne SYMFONY__ENV__* igen ved hver start af containeren og tømmer cachen. Når du har ændret compose.yaml, genopretter docker compose up -d containeren og anvender de nye indstillinger.
/var/www/wallabag/data/db/wallabag.sqlite; montér i så fald et volumen på /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, port 5432, og POSTGRES_USER og POSTGRES_PASSWORD, så imaget opretter databasen. Version 2.6.15 af imaget retter ejerskabet af databasen med PostgreSQL 15 og nyere.POPULATE_DATABASE=False, og initialisér den derefter én gang med docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. README beder dig køre denne kommando som nobody, så ingen filer ender med at tilhøre root.Den vej, dokumentationen anbefaler på en dedikeret server, er Git-repositoriet og dets Makefile, med Composer, værktøjet make og PHP-udvidelserne fra siden med krav:
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install
Webserveren leverer derefter mappen web, med app.php som indgangspunkt: siden om virtuelle værter giver konfigurationer til Nginx, Apache, Caddy og lighttpd. Dens eksempler leverer wallabag i roden af et domæne eller underdomæne, den opsætning som vedligeholderne understøtter.
Installationen opretter en administratorkonto, hvis brugernavn og adgangskode begge er wallabag, med adressen wallabag@wallabag.io. Skift dem, før du åbner instansen for offentligheden. En SSH-tunnel henter serverens port 8080 til din computer, på http://localhost:8080; tilføj -p og den SSH-port, der står i dit kundeområde.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag og wallabag.| Variabel | Standardværdi | Hvad den gør |
|---|---|---|
SYMFONY__ENV__SECRET | En offentlig streng, den samme for alle instanser | Tilfører entropi til sikkerhedsoperationerne: dokumentationen vil have den unik for din instans |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | Den fulde adresse på din instans, uden skråstreg til sidst |
SYMFONY__ENV__FOSUSER_REGISTRATION | false i Docker-imaget | Åbner eller lukker for offentlig tilmelding |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Sender en bekræftelsesmail ved hver tilmelding |
SYMFONY__ENV__LOCALE | en | Instansens standardsprog, såsom fr |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | Det navn på instansen, som din tofaktor-app viser |
Med Docker-imaget er offentlig tilmelding altså lukket. For at åbne instansen for dit team opretter du selv kontiene fra «Users management», eller du åbner for tilmelding, mens folk melder sig til, med bekræftelse via e-mail.
De mere følsomme indstillinger ligger under «Internal Settings», forbeholdt instansens administrator: offentlig deling af artikler, eksportformater, login på sider med betalingsmur, lokal download af billeder og importer i baggrunden.
Containeren leverer wallabag over HTTP, på sin port 80, gennem en intern Nginx. HTTPS håndteres af reverse proxyen foran den. Den interne Nginx læser headeren X-Forwarded-Proto: når den er https, fortæller den PHP, at forespørgslen er krypteret, og wallabag bygger sine links og cookies derefter.
X-Forwarded-Proto: proxyen skal sende den med værdien https.Host: dit domænenavn, så applikationens omdirigeringer peger på det.Caddy henter selv certifikatet fra Let’s Encrypt og fornyer det. Dets direktiv reverse_proxy bevarer headeren Host og tilføjer som standard X-Forwarded-For, X-Forwarded-Proto og X-Forwarded-Host:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
Denne blok bruger headerne fra Nginx-eksemplet i Docker-imagets README, tilføjer headeren Host og imagets uploadgrænse og lytter på port 80, så Certbot kan sætte HTTPS op:
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
Kontrollér derefter, at SYMFONY__ENV__DOMAIN_NAME indeholder adressen med https://, den samme som din proxys.
wallabag fungerer i browseren, og projektet udgiver også apps og en udvidelse, som forbinder til din instans via dens adresse, uden skråstreg til sidst.
| Værktøj | Hvad det gør | Hvad det kræver |
|---|---|---|
| Android-app | Synkroniserer dine artikellister og viser dem på din telefon | Instansens adresse, dit brugernavn og din adgangskode; appen henter selv sine loginoplysninger til feeds |
| iOS-app | Viser dine artikler på iPhone og iPad | Adressen, et klient-id og en hemmelighed til API'et, dit brugernavn og din adgangskode |
| Udvidelsen wallabagger, til Firefox og Chrome | Gemmer den åbne side, med dens tags, som favorit eller arkiveret | Adressen, et klient-id og en hemmelighed til API'et, dit brugernavn og din adgangskode |
| Bookmarkletten «bag it!» | Gemmer den åbne side fra bogmærkelinjen | Intet: du trækker den fra siden «Howto» |
Menuen «Import» henter dine artikler fra en anden tjeneste. wallabag henter indholdet af hver artikel igen, hvilket tager tid ved en stor eksport. Importværktøjerne i version 2.6.17:
| Tjeneste | Den fil, der skal leveres |
|---|---|
| Pocket, CSV-eksport | Pockets eksport-ZIP, udpakket: en CSV-fil med et navn som part_000000.csv |
| Pocket, HTML-eksport | HTML-filen fra Pockets ældre eksport, som ril_export.html |
| Instapaper | CSV-filen fra Instapapers indstillingsside |
| Omnivore | Filerne metadata_x_to_y.json fra den udpakkede eksport, én ad gangen |
| Pinboard, Delicious | Deres JSON-eksport |
| Shaarli | Dets HTML-eksport |
| Firefox, Chrome | Firefox’ JSON-backup af bogmærker eller Chromes fil Bookmarks |
| Readability, elCurator | Deres eksport |
| wallabag 1.x eller 2.x | JSON-eksporten fra en anden instans |
Version 2.6.17 bringer også en rettelse af CSV-importen fra Pocket. Import via Pocket-API'et findes også, med en udviklernøgle, som administratoren sætter i konfigurationen.
For at en stor import ikke skal holde siden tilbage, overdrager wallabag den til Redis, som compose.yaml ovenfor allerede sørger for:
1.pocket_csv; den arbejder sig gennem køen og bliver derefter ved med at lytte, indtil du stopper den.docker compose run --rm wallabag import pocket_csv
De andre typer er pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox og chrome.
wallabag sender e-mails til bekræftelse af tilmelding, nulstilling af adgangskoder og tofaktorkoder via e-mail. Det sender dem gennem den server, som SYMFONY__ENV__MAILER_DSN beskriver, som standard smtp://127.0.0.1.
Konfigurér på en VPS fra Simafri en godkendt SMTP-server, på port 587 eller 465: dit domænes mailtjeneste eller en afsendelsestjeneste. Dokumentationen giver formatet på én linje, med bruger, adgangskode, server og 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
@ bliver til %40. Hvis et kodet tegn standser opstarten, foreslår dokumentationen at fordoble procenttegnet: %%40.FROM_EMAIL er afsenderen af alle e-mails fra wallabag, TWOFACTOR_SENDER afsenderen af tofaktorkoder. Brug en adresse på dit domæne, som din SMTP-server accepterer at sende fra.:465 i slutningen af linjen.Genopret derefter containeren med docker compose up -d, og test med et link «Forgot your password?» fra loginsiden.
Dokumentationens side om backup nævner tre elementer: indstillingerne, databasen og billederne. Med Docker-imaget ligger hver af dem her:
| Element | Hvor det ligger | Sådan kopierer du det |
|---|---|---|
| Indstillingerne | Din compose.yaml: imaget bygger parameters.yml ud fra den ved hver start | En kopi af filen, opbevaret sikkert, da den indeholder dine hemmeligheder |
| Databasen | Volumen wallabag-db | En eksport med mariadb-dump |
| Billederne | Volumen wallabag-images, monteret på web/assets/images | Et arkiv af 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
Planlæg disse kopier, og send dem væk fra serveren. Gemt på dens disk indgår disse arkiver også i dens natlige backup. Med SQLite beder dokumentationen dig kopiere mappen data/db.
På en ny installation starter du stakken med den samme compose.yaml og indlæser derefter databasen og billederne 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
Hver bruger kan også eksportere sine artikler som JSON, fra listen «All entries», og importere dem igen i en anden instans med importværktøjet til wallabag 2.x. For administratorer eksporterer kommandoen wallabag:export en brugers artikler til en fil.
Med Docker ændrer du imagets tag i compose.yaml, tager en backup, henter derefter det nye image og genopretter containeren. README beder dig derefter køre databasemigreringerne, når en udgivelse har nogen med:
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, og udgivelsesnoterne beder dig tømme den gamle mappe web/uploads/import. I denne compose.yaml ligger den mappe inde i containeren: den, der oprettes ud fra det nye image, starter uden den.make update, som på instanser med 2.6.15 eller ældre valgte en alfaudgivelse, der blev udgivet samme morgen. For en Git-installation, der er gået i stå, giver udgivelsesnoterne reparationen: git checkout 2.6.17 --force og derefter make update.make update, som også kører migreringerne og tømmer cachen.Læs udgivelsesnoterne for hver version, før du opdaterer: de gør opmærksom på de trin, der gælder netop den version, såsom mappen, der skal tømmes i 2.6.16.
Selvhosting kræver, at du holder serveren ud over selve applikationen. På en Managed VPS tager vores teams sig af serveren og følger din instans proaktivt; wallabag forbliver din software, med dens indstillinger og dine artikler.
| Emne | Vores teams | Dig |
|---|---|---|
| Serveren | Opdateringer af system og sikkerhed, indgreb på serveren inkluderet | Det tidspunkt, der passer til din drift |
| Overvågningen | Serveren følges døgnet rundt, alle ugens dage, med indgreb uden at vente på dit opkald | Gennemlæsning af din instans' logfiler |
| wallabag | Proaktiv opfølgning: fejl, langsomme svartider, database og diskplads opdages, og en rettelse anbefales | Installation, opdateringer og indstillinger, som du gennemfører, selv eller med din AI-assistent |
| Konti og artikler | Den server, der bærer dem, overvåget og sikkerhedskopieret | Brugerne, tilmeldingerne, API-klienterne og importerne |
| Backup | Hver nat, krypteret og opbevaret uden for maskinen; gendannelse inkluderet | De eksporter, der er specifikke for wallabag, og anmodningen om gendannelse, når du får brug for den |
| Migreringen | Din nuværende server flyttes, uden beregning | Tidspunktet for omlægningen |
Hvis du foretrækker, at vores teams griber ind i selve applikationen, faktureres den ydelse pr. time eller som fast pris, med et overslag oplyst før indgrebet.
Med en Managed VPS fra Simafri holder vores teams serveren bag din wallabag-instans opdateret, overvåger den dag og nat og griber ind uden at vente på dit opkald; de følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører, selv eller med din AI-assistent. Backup krypteres hver nat og opbevares uden for maskinen, gendannelsen er inkluderet, og migreringen af din nuværende server sker uden beregning.
Ja. wallabag er under MIT-licensen: du kan bruge, ændre og videredistribuere det, både i virksomheder og andre steder, uden at købe en licens, så længe du beholder dets copyrightmeddelelse. Tilbage står udgiften til den server, der kører det.
Tag udgangspunkt i eksemplet på compose.yaml fra imaget wallabag/wallabag, med MariaDB og Redis. Sæt SYMFONY__ENV__SECRET, adgangskoderne og din adresse i SYMFONY__ENV__DOMAIN_NAME, publicér porten på 127.0.0.1, kør derefter docker compose up -d, og sæt en reverse proxy med HTTPS foran.
Installationen opretter en administrator, hvis brugernavn og adgangskode begge er wallabag. Skift adgangskoden under Config, fanen Password, og e-mailadressen under User information, før du åbner instansen for offentligheden.
Pak Pockets eksport-ZIP ud: den indeholder en CSV-fil som part_000000.csv. Vælg Pocket CSV i menuen Import, og upload den fil. wallabag henter derefter indholdet af hver artikel; ved en stor eksport skal du aktivere Redis i de interne indstillinger.
Projektet udgiver apps til Android og iOS og udvidelsen wallabagger til Firefox og Chrome, som forbinder til din instans via dens adresse, uden skråstreg til sidst. iOS og wallabagger kræver en API-klient, som oprettes i API clients management.
Imaget læser headeren X-Forwarded-Proto for at vide, at forespørgslen kommer via HTTPS. Lad din proxy sende den med værdien https, sammen med headeren Host for dit domæne, og sæt adressen med https:// i SYMFONY__ENV__DOMAIN_NAME.
Kopiér tre elementer: databasen, med mariadb-dump til MariaDB, volumen med billederne, monteret på web/assets/images, og din compose.yaml, som indeholder indstillingerne og hemmelighederne. Send disse kopier væk fra serveren.
En Managed VPS dækker serveren: system, sikkerhed, overvågning og backup. Vores teams følger også din instans proaktivt og anbefaler dig de nyttige rettelser, som du gennemfører. Et indgreb i selve applikationen faktureres pr. time eller som fast pris.
Simafri
Lad os tale om din hjemmeside
Fortæl os om dit projekt med få ord: vi vender hurtigt tilbage til dig.
Tak! Din forespørgsel er sendt. Vi vender tilbage til dig hurtigst muligt.
Foretrækker du e-mail? Skriv til os på support@simafri.com.