Ospitare wallabag su un VPS gestito: le vostre letture, sul vostro server

Ospitare wallabag su un VPS gestito significa conservare gli articoli che mettete da parte per dopo su una macchina tutta vostra, che i nostri team tengono aggiornata e supervisionano giorno e notte. wallabag è un'applicazione libera di lettura differita con licenza MIT. Questa guida segue la sua documentazione ufficiale e la sua immagine Docker, alla versione 2.6.17: l'installazione con Docker Compose, il primo account e i segreti, HTTPS, le app e le estensioni, l'importazione da Pocket e da altri servizi, le e-mail, i backup e gli aggiornamenti.

Simon Vasconcelos Lee Di Pubblicato il 18 novembre 2026Lettura: 14 minuti

Tutte le guide

In breve

  1. La licenza MIT permette di usare, modificare e ridistribuire wallabag liberamente, in azienda come altrove, a condizione di conservarne l'avviso di copyright.
  2. Installatelo con Docker Compose: l'immagine ufficiale wallabag/wallabag, MariaDB, Redis e la porta web pubblicata su 127.0.0.1 dietro un reverse proxy in HTTPS.
  3. Prima del primo avvio, impostate SYMFONY__ENV__SECRET e il vostro indirizzo pubblico in SYMFONY__ENV__DOMAIN_NAME; poi cambiate la password dell'account wallabag, che è wallabag.
  4. Il reverse proxy invia X-Forwarded-Proto: https: è così che wallabag sa che i suoi visitatori arrivano in HTTPS.
  5. Salvate il database, il volume delle immagini e il vostro compose.yaml, poi aggiornate cambiando il tag dell'immagine ed eseguendo le migrazioni.

Cosa fa wallabag

wallabag è un'applicazione web di lettura differita: salvate una pagina con un clic e la leggete quando avete tempo. Il suo README la riassume così: cliccare, salvare, leggere quando volete. wallabag estrae il contenuto dell'articolo, così i pop-up della pagina originale non vi distraggono.

Cosa permette la licenza MIT

wallabag è pubblicato con la licenza MIT, copyright Nicolas Lœuillet dal 2013. Concede gratuitamente il diritto di usare, copiare, modificare, unire, pubblicare, distribuire, concedere in sublicenza e vendere copie del software. Potete quindi farlo girare per voi, per il vostro team o per i vostri clienti, senza alcuna licenza da acquistare.

L'unica condizione è conservare l'avviso di copyright e il testo della licenza in tutte le copie o parti sostanziali del software. Il testo fornisce il software «così com'è», senza garanzia.

Le risorse da prevedere

La documentazione di wallabag non indica cifre per la memoria o la CPU. Elenca però ciò di cui l'applicazione ha bisogno, e l'immagine Docker fissa alcuni valori utili al dimensionamento:

La dimensione del server dipende quindi dal numero di utenti, dal volume di articoli e dalle vostre importazioni. Su un VPS gestito, descriveteci il vostro utilizzo e vi consiglieremo la dimensione giusta.

L'installazione con Docker Compose

Il repository wallabag/docker pubblica l'immagine ufficiale wallabag/wallabag su Docker Hub e su GitHub Container Registry, con un file Compose di esempio: wallabag, un database MariaDB e Redis. Su un server con Docker installato, create una cartella e metteteci questo compose.yaml, basato su quell'esempio:

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:

Sostituite i tre valori segreti prima del primo avvio. Le stringhe esadecimali funzionano ovunque, anche nei comandi SQL che l'immagine scrive per creare il database:

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

Per verificare che l'applicazione risponda, interrogate il percorso usato dal controllo di stato dell'immagine:

Terminale
curl http://127.0.0.1:8080/api/info

L'immagine rilegge le variabili SYMFONY__ENV__* a ogni avvio del container e svuota la cache. Dopo aver modificato il compose.yaml, un docker compose up -d ricrea il container e applica le nuove impostazioni.

Con SQLite o PostgreSQL

Senza Docker

La via che la documentazione raccomanda su un server dedicato è il repository Git e il suo Makefile, con Composer, lo strumento make e le estensioni PHP della pagina dei requisiti:

Terminale
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install

Il server web serve allora la cartella web, con app.php come punto di ingresso: la pagina sui virtual host fornisce le configurazioni per Nginx, Apache, Caddy e lighttpd. I suoi esempi servono wallabag alla radice di un dominio o di un sottodominio, la configurazione supportata dai maintainer.

Il primo account, i segreti e le registrazioni

L'installazione crea un account amministratore il cui nome utente e la cui password sono entrambi wallabag, con l'indirizzo wallabag@wallabag.io. Cambiateli prima di aprire l'istanza al pubblico. Un tunnel SSH porta la porta 8080 del server sul vostro computer, su http://localhost:8080; aggiungete -p e la porta SSH indicata nella vostra area clienti.

Terminale, sul vostro computer
ssh -L 8080:127.0.0.1:8080 user@read.example.com
  1. Accedete con wallabag e wallabag.
  2. In «Config», scheda «Password», scegliete una nuova password di almeno 8 caratteri.
  3. Nella scheda «User information», sostituite l'indirizzo e-mail con il vostro: è quello che riceve i link per reimpostare la password.
  4. Nella stessa scheda, attivate l'autenticazione a due fattori. La documentazione raccomanda un'app di codici monouso, come FreeOTP, piuttosto che il codice inviato via e-mail; wallabag offre anche dei codici di backup.
VariabileValore predefinitoCosa fa
SYMFONY__ENV__SECRETUna stringa pubblica, la stessa per tutte le istanzeAggiunge entropia alle operazioni di sicurezza: la documentazione la vuole unica per la vostra istanza
SYMFONY__ENV__DOMAIN_NAMEhttps://your-wallabag-instance.wallabag.orgL'indirizzo completo della vostra istanza, senza barra finale
SYMFONY__ENV__FOSUSER_REGISTRATIONfalse nell'immagine DockerApre o chiude la registrazione pubblica
SYMFONY__ENV__FOSUSER_CONFIRMATIONtrueInvia una e-mail di conferma per ogni registrazione
SYMFONY__ENV__LOCALEenLa lingua predefinita dell'istanza, come it
SYMFONY__ENV__SERVER_NAMEYour wallabag instanceIl nome dell'istanza mostrato nella vostra app di autenticazione a due fattori

Con l'immagine Docker la registrazione pubblica è quindi chiusa. Per aprire l'istanza al vostro team, create voi stessi gli account da «Users management», oppure aprite la registrazione il tempo che le persone si iscrivano, con conferma via e-mail.

Le impostazioni più delicate si trovano in «Internal Settings», riservate all'amministratore dell'istanza: la condivisione pubblica degli articoli, i formati di esportazione, l'accesso ai siti a pagamento, il download locale delle immagini e le importazioni in background.

HTTPS: il reverse proxy

Il container serve wallabag in HTTP, sulla sua porta 80, tramite un Nginx interno. HTTPS è affidato al reverse proxy posto davanti. Questo Nginx interno legge l'intestazione X-Forwarded-Proto: quando vale https, comunica a PHP che la richiesta è cifrata, e wallabag costruisce di conseguenza i suoi link e i suoi cookie.

Con Caddy

Caddy ottiene da solo il certificato Let’s Encrypt e lo rinnova. La sua direttiva reverse_proxy conserva l'intestazione Host e aggiunge per impostazione predefinita X-Forwarded-For, X-Forwarded-Proto e X-Forwarded-Host:

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

Con Nginx

Questo blocco riprende le intestazioni dell'esempio Nginx del README dell'immagine Docker, aggiunge l'intestazione Host e il limite di caricamento dell'immagine, e ascolta sulla porta 80 perché Certbot possa installare HTTPS:

Blocco Nginx
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;
    }
}
Terminale
sudo nginx -t
sudo certbot --nginx

Verificate poi che SYMFONY__ENV__DOMAIN_NAME contenga l'indirizzo in https://, lo stesso del vostro proxy.

Le app, le estensioni e i feed RSS

wallabag funziona nel browser, e il progetto pubblica anche delle app e un'estensione, che si collegano alla vostra istanza tramite il suo indirizzo, senza barra finale.

StrumentoCosa faCosa richiede
App AndroidSincronizza le vostre liste di articoli e le mostra sul telefonoL'indirizzo dell'istanza, il vostro nome utente e la vostra password; l'app recupera da sola i suoi accessi ai feed
App iOSMostra i vostri articoli su iPhone e iPadL'indirizzo, un ID e un segreto di client API, il vostro nome utente e la vostra password
Estensione wallabagger, per Firefox e ChromeSalva la pagina aperta, con i suoi tag, tra i preferiti o in archivioL'indirizzo, un ID e un segreto di client API, il vostro nome utente e la vostra password
Bookmarklet «bag it!»Salva la pagina aperta dalla barra dei segnalibriNiente: si trascina dalla pagina «Howto»

Importare i vostri articoli da Pocket e da altri servizi

Il menu «Import» porta i vostri articoli da un altro servizio. wallabag scarica di nuovo il contenuto di ogni articolo, il che richiede tempo con un'esportazione voluminosa. Gli importatori della versione 2.6.17:

ServizioIl file da fornire
Pocket, esportazione CSVLo ZIP di esportazione di Pocket, una volta estratto: un file CSV con un nome come part_000000.csv
Pocket, esportazione HTMLIl file HTML della vecchia esportazione di Pocket, come ril_export.html
InstapaperIl CSV della pagina delle impostazioni di Instapaper
OmnivoreI file metadata_x_to_y.json dell'esportazione estratta, uno alla volta
Pinboard, DeliciousLa loro esportazione JSON
ShaarliLa sua esportazione HTML
Firefox, ChromeIl backup JSON dei segnalibri di Firefox, o il file Bookmarks di Chrome
Readability, elCuratorLa loro esportazione
wallabag 1.x o 2.xL'esportazione JSON di un'altra istanza

La versione 2.6.17 porta inoltre una correzione all'importazione CSV di Pocket. Esiste anche l'importazione tramite l'API di Pocket, con una chiave sviluppatore che l'amministratore inserisce nella configurazione.

Le grandi importazioni in background

Perché una grande importazione non blocchi la pagina, wallabag la affida a Redis, che il compose.yaml qui sopra prevede già:

  1. In «Internal Settings», sezione «Import», attivate Redis con il valore 1.
  2. Avviate l'importazione dal menu «Import»: wallabag mette gli articoli in una coda.
  3. Avviate il worker del tipo di importazione scelto, per esempio pocket_csv; smaltisce la coda, poi resta in ascolto finché non lo fermate.
Terminale, nella cartella del compose.yaml
docker compose run --rm wallabag import pocket_csv

Gli altri tipi sono pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox e chrome.

Le e-mail: la configurazione SMTP

wallabag invia e-mail per la conferma delle registrazioni, il ripristino delle password e i codici di autenticazione a due fattori via e-mail. Le invia attraverso il server descritto da SYMFONY__ENV__MAILER_DSN, che per impostazione predefinita è smtp://127.0.0.1.

Su un VPS Simafri, configurate un server SMTP autenticato, sulla porta 587 o 465: il servizio di posta del vostro dominio, o un servizio di invio. La documentazione fornisce il formato su una sola riga, con utente, password, server e porta:

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

Ricreate poi il container con docker compose up -d, e fate una prova con il link «Forgot your password?» della pagina di accesso.

I backup

La pagina sui backup della documentazione indica tre elementi: le impostazioni, il database e le immagini. Con l'immagine Docker, ecco dove si trova ciascuno:

ElementoDove si trovaCome copiarlo
Le impostazioniIl vostro compose.yaml: l'immagine ne ricava parameters.yml a ogni avvioUna copia del file, conservata al sicuro, perché contiene i vostri segreti
Il databaseIl volume wallabag-dbUn'esportazione con mariadb-dump
Le immaginiIl volume wallabag-images, montato su web/assets/imagesUn archivio della cartella
Terminale, nella cartella del 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

Pianificate queste copie e inviatele fuori dal server. Conservati sul suo disco, questi archivi rientrano anche nei suoi backup notturni. Con SQLite, la documentazione chiede di copiare la cartella data/db.

Il ripristino

Su una nuova installazione, avviate lo stack con lo stesso compose.yaml, poi ricaricate il database e le immagini:

Terminale
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

Ogni utente può anche esportare i propri articoli in JSON, dalla lista «All entries», e importarli di nuovo in un'altra istanza con l'importatore wallabag 2.x. Per gli amministratori, il comando wallabag:export esporta in un file gli articoli di un utente.

Gli aggiornamenti

Con Docker, cambiate il tag dell'immagine nel compose.yaml, fate un backup, poi scaricate la nuova immagine e ricreate il container. Il README chiede quindi di eseguire le migrazioni del database quando una versione ne porta:

Terminale, nella cartella del 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

Leggete le note di rilascio di ogni versione prima di aggiornare: segnalano i passaggi propri di quella versione, come la cartella da svuotare nella 2.6.16.

Chi fa che cosa su un VPS gestito

Il self-hosting richiede di occuparsi del server oltre che dell'applicazione. Su un VPS gestito, i nostri team prendono in carico il server e seguono la vostra istanza in modo proattivo; wallabag resta il vostro software, con le sue impostazioni e i vostri articoli.

ArgomentoI nostri teamVoi
Il serverAggiornamenti del sistema e della sicurezza, interventi sul server compresiIl momento più adatto alla vostra attività
La supervisioneServer seguito 24 ore su 24, 7 giorni su 7, con intervento senza attendere la vostra chiamataLa lettura dei log della vostra istanza
wallabagMonitoraggio proattivo: errori, rallentamenti, database e spazio su disco individuati, correzione raccomandataLa sua installazione, i suoi aggiornamenti e le sue impostazioni, che applicate voi o il vostro assistente IA
Gli account e gli articoliIl server che li ospita, sorvegliato e salvatoGli utenti, le registrazioni, i client API e le importazioni
I backupOgni notte, cifrati e conservati fuori dalla macchina; ripristino compresoLe esportazioni proprie di wallabag e la richiesta di ripristino, quando ne avete bisogno
La migrazioneIl vostro server attuale migrato, in omaggioIl momento del passaggio

Se preferite che i nostri team intervengano nell'applicazione stessa, questa prestazione si fattura a ore o a forfait, con un preventivo comunicato prima dell'intervento.

wallabag, su un server gestito per voi

Con un VPS gestito Simafri, i nostri team tengono aggiornato il server della vostra istanza wallabag, lo sorvegliano giorno e notte e intervengono senza attendere la vostra chiamata; seguono anche la vostra istanza in modo proattivo e vi raccomandano le correzioni utili, che applicate voi o il vostro assistente IA. I backup sono cifrati ogni notte e conservati fuori dalla macchina, il loro ripristino è compreso e la migrazione del vostro server attuale è in omaggio.

Scoprire i VPS gestiti

Domande frequenti

wallabag è gratuito?

Sì. wallabag ha licenza MIT: potete usarlo, modificarlo e ridistribuirlo, in azienda come altrove, senza alcuna licenza da acquistare, a condizione di conservarne l'avviso di copyright. Resta il costo del server che lo fa girare.

Come installare wallabag con Docker Compose?

Partite dal compose.yaml di esempio dell'immagine wallabag/wallabag, con MariaDB e Redis. Impostate SYMFONY__ENV__SECRET, le password e il vostro indirizzo in SYMFONY__ENV__DOMAIN_NAME, pubblicate la porta su 127.0.0.1, poi eseguite docker compose up -d e mettete davanti un reverse proxy in HTTPS.

Quali sono le credenziali predefinite di wallabag?

L'installazione crea un amministratore il cui nome utente e la cui password sono entrambi wallabag. Cambiate la password in Config, scheda Password, e l'indirizzo e-mail in User information, prima di aprire l'istanza al pubblico.

Come importare i miei articoli di Pocket in wallabag?

Estraete lo ZIP di esportazione di Pocket: contiene un file CSV come part_000000.csv. Nel menu Import, scegliete Pocket CSV e caricate quel file. wallabag scarica allora il contenuto di ogni articolo; per un'esportazione voluminosa, attivate Redis nelle impostazioni interne.

Quali app funzionano con wallabag?

Il progetto pubblica app per Android e iOS e l'estensione wallabagger per Firefox e Chrome, che si collegano alla vostra istanza tramite il suo indirizzo, senza barra finale. iOS e wallabagger richiedono un client API, creato in API clients management.

Perché i link di wallabag restano in http dietro un proxy?

L'immagine legge l'intestazione X-Forwarded-Proto per sapere che la richiesta arriva in HTTPS. Fate in modo che il vostro proxy la invii con il valore https, insieme all'intestazione Host del vostro dominio, e mettete l'indirizzo in https:// in SYMFONY__ENV__DOMAIN_NAME.

Come fare il backup di wallabag?

Copiate tre elementi: il database, con mariadb-dump per MariaDB, il volume delle immagini montato su web/assets/images, e il vostro compose.yaml, che contiene le impostazioni e i segreti. Inviate queste copie fuori dal server.

Un VPS gestito copre wallabag?

Un VPS gestito copre il server: sistema, sicurezza, supervisione e backup. I nostri team seguono anche la vostra istanza in modo proattivo e vi raccomandano le correzioni utili, che applicate voi. Un intervento nell'applicazione si fattura a ore o a forfait.

Fonti e documentazione ufficiale

Guide correlate

Ospitare FreshRSS su un VPS gestito: i vostri feed RSS sul vostro serverOspitare FreshRSS su un VPS gestito significa leggere, voi e il vostro team, i vostri feed RSS da una macchina tutta vostra, che i nostri team tengono aggiornata e supervisionano giorno e notte. FreshRSS è un software libero con licenza AGPL-3.0. Questa guida segue la sua documentazione ufficiale: l'installazione con Docker Compose, HTTPS, l'aggiornamento dei feed, gli account e l'accesso, l'API per le app mobili, il database, i backup e gli aggiornamenti.Backup di un VPS: che cosa verificare prima di firmareUn'offerta di VPS annuncia quasi sempre «backup compresi». Dietro queste due parole può esserci una copia ogni notte, conservata fuori dalla macchina e ripristinata da esperti, oppure uno snapshot posato sullo stesso disco del server. Questa guida indica le domande che fanno la differenza, che cosa significa ogni risposta, e il modo di verificare che un backup si possa ripristinare.Differenza tra VPS gestito e non gestito: chi fa che cosaLa differenza tra un VPS gestito e un VPS non gestito si riduce a una domanda: chi si occupa del server una volta che è in funzione. La parola «gestito», o «managed», non ha però una definizione ufficiale: da un provider all'altro, va dalla semplice installazione del sistema alla gestione completa del server. Questa guida mostra chi fa che cosa, voce per voce, con il livello intermedio dell'assistenza, e indica le domande che chiariscono ogni ambiguità prima di firmare.
Contattaci