Hoste wallabag på en Managed VPS: din læseliste på din egen server

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.

Simon Vasconcelos Lee Af Udgivet den 18. november 2026Læsetid: 14 minutter

Alle guider

Det vigtigste

  1. MIT-licensen tillader at bruge, ændre og videredistribuere wallabag frit, både i virksomheder og andre steder, så længe du beholder dens copyrightmeddelelse.
  2. Installér med Docker Compose: det officielle image wallabag/wallabag, MariaDB, Redis og webporten publiceret på 127.0.0.1 bag en reverse proxy med HTTPS.
  3. Sæt 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.
  4. Reverse proxyen sender X-Forwarded-Proto: https: sådan ved wallabag, at dets besøgende kommer via HTTPS.
  5. Tag backup af databasen, volumen med billederne og din compose.yaml, og opdatér derefter ved at ændre imagets tag og køre migreringerne.

Hvad wallabag gør

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.

Hvad MIT-licensen tillader

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.

De ressourcer, du skal regne med

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:

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.

Installation med Docker Compose

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:

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

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

For at kontrollere, at applikationen svarer, kan du spørge på den rute, som imagets healthcheck bruger:

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

Med SQLite eller PostgreSQL

Uden Docker

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:

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

Den første konto, hemmelighederne og tilmeldinger

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.

Terminal, på din computer
ssh -L 8080:127.0.0.1:8080 user@read.example.com
  1. Log ind med wallabag og wallabag.
  2. Vælg under «Config», fanen «Password», en ny adgangskode på mindst 8 tegn.
  3. Erstat i fanen «User information» e-mailadressen med din egen: den modtager linkene til nulstilling af adgangskoden.
  4. Slå tofaktorgodkendelse til i samme fane. Dokumentationen anbefaler en app til engangskoder, såsom FreeOTP, frem for koden sendt via e-mail; wallabag tilbyder også backupkoder.
VariabelStandardværdiHvad den gør
SYMFONY__ENV__SECRETEn offentlig streng, den samme for alle instanserTilfører entropi til sikkerhedsoperationerne: dokumentationen vil have den unik for din instans
SYMFONY__ENV__DOMAIN_NAMEhttps://your-wallabag-instance.wallabag.orgDen fulde adresse på din instans, uden skråstreg til sidst
SYMFONY__ENV__FOSUSER_REGISTRATIONfalse i Docker-imagetÅbner eller lukker for offentlig tilmelding
SYMFONY__ENV__FOSUSER_CONFIRMATIONtrueSender en bekræftelsesmail ved hver tilmelding
SYMFONY__ENV__LOCALEenInstansens standardsprog, såsom fr
SYMFONY__ENV__SERVER_NAMEYour wallabag instanceDet 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.

HTTPS: reverse proxyen

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.

Med Caddy

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:

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

Med Nginx

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:

Nginx-blok
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;
    }
}
Terminal
sudo nginx -t
sudo certbot --nginx

Kontrollér derefter, at SYMFONY__ENV__DOMAIN_NAME indeholder adressen med https://, den samme som din proxys.

Apps, browserudvidelser og RSS-feeds

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øjHvad det gørHvad det kræver
Android-appSynkroniserer dine artikellister og viser dem på din telefonInstansens adresse, dit brugernavn og din adgangskode; appen henter selv sine loginoplysninger til feeds
iOS-appViser dine artikler på iPhone og iPadAdressen, et klient-id og en hemmelighed til API'et, dit brugernavn og din adgangskode
Udvidelsen wallabagger, til Firefox og ChromeGemmer den åbne side, med dens tags, som favorit eller arkiveretAdressen, et klient-id og en hemmelighed til API'et, dit brugernavn og din adgangskode
Bookmarkletten «bag it!»Gemmer den åbne side fra bogmærkelinjenIntet: du trækker den fra siden «Howto»

Import af dine artikler fra Pocket og andre steder

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:

TjenesteDen fil, der skal leveres
Pocket, CSV-eksportPockets eksport-ZIP, udpakket: en CSV-fil med et navn som part_000000.csv
Pocket, HTML-eksportHTML-filen fra Pockets ældre eksport, som ril_export.html
InstapaperCSV-filen fra Instapapers indstillingsside
OmnivoreFilerne metadata_x_to_y.json fra den udpakkede eksport, én ad gangen
Pinboard, DeliciousDeres JSON-eksport
ShaarliDets HTML-eksport
Firefox, ChromeFirefox’ JSON-backup af bogmærker eller Chromes fil Bookmarks
Readability, elCuratorDeres eksport
wallabag 1.x eller 2.xJSON-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.

Store importer i baggrunden

For at en stor import ikke skal holde siden tilbage, overdrager wallabag den til Redis, som compose.yaml ovenfor allerede sørger for:

  1. Aktivér Redis under «Internal Settings», afsnittet «Import», med værdien 1.
  2. Start importen fra menuen «Import»: wallabag sætter artiklerne i en kø.
  3. Start workeren for den valgte importtype, for eksempel pocket_csv; den arbejder sig gennem køen og bliver derefter ved med at lytte, indtil du stopper den.
Terminal, i mappen med compose.yaml
docker compose run --rm wallabag import pocket_csv

De andre typer er pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox og chrome.

E-mail: SMTP-konfigurationen

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:

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

Genopret derefter containeren med docker compose up -d, og test med et link «Forgot your password?» fra loginsiden.

Backup

Dokumentationens side om backup nævner tre elementer: indstillingerne, databasen og billederne. Med Docker-imaget ligger hver af dem her:

ElementHvor det liggerSådan kopierer du det
IndstillingerneDin compose.yaml: imaget bygger parameters.yml ud fra den ved hver startEn kopi af filen, opbevaret sikkert, da den indeholder dine hemmeligheder
DatabasenVolumen wallabag-dbEn eksport med mariadb-dump
BillederneVolumen wallabag-images, monteret på web/assets/imagesEt arkiv af mappen
Terminal, i mappen med 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

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.

Gendannelse

På en ny installation starter du stakken med den samme compose.yaml og indlæser derefter databasen og billederne igen:

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

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.

Opdateringer

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:

Terminal, i mappen med 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

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.

Hvem gør hvad på en Managed VPS

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.

EmneVores teamsDig
ServerenOpdateringer af system og sikkerhed, indgreb på serveren inkluderetDet tidspunkt, der passer til din drift
OvervågningenServeren følges døgnet rundt, alle ugens dage, med indgreb uden at vente på dit opkaldGennemlæsning af din instans' logfiler
wallabagProaktiv opfølgning: fejl, langsomme svartider, database og diskplads opdages, og en rettelse anbefalesInstallation, opdateringer og indstillinger, som du gennemfører, selv eller med din AI-assistent
Konti og artiklerDen server, der bærer dem, overvåget og sikkerhedskopieretBrugerne, tilmeldingerne, API-klienterne og importerne
BackupHver nat, krypteret og opbevaret uden for maskinen; gendannelse inkluderetDe eksporter, der er specifikke for wallabag, og anmodningen om gendannelse, når du får brug for den
MigreringenDin nuværende server flyttes, uden beregningTidspunktet 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.

wallabag på en server, der passes for dig

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.

Opdag Managed VPS

Ofte stillede spørgsmål

Er wallabag gratis?

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.

Hvordan installerer jeg wallabag med Docker Compose?

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.

Hvad er standardloginoplysningerne til wallabag?

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.

Hvordan importerer jeg mine Pocket-artikler i wallabag?

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.

Hvilke apps fungerer med wallabag?

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.

Hvorfor bliver links i wallabag på http bag en proxy?

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.

Hvordan tager jeg backup af wallabag?

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.

Dækker en Managed VPS wallabag?

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.

Kilder og officiel dokumentation

Kontakt os