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.
Di Simon Vasconcelos Lee
Pubblicato il 18 novembre 2026Lettura: 14 minuti
wallabag/wallabag, MariaDB, Redis e la porta web pubblicata su 127.0.0.1 dietro un reverse proxy in HTTPS.SYMFONY__ENV__SECRET e il vostro indirizzo pubblico in SYMFONY__ENV__DOMAIN_NAME; poi cambiate la password dell'account wallabag, che è wallabag.X-Forwarded-Proto: https: è così che wallabag sa che i suoi visitatori arrivano in HTTPS.compose.yaml, poi aggiornate cambiando il tag dell'immagine ed eseguendo le migrazioni.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.
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.
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:
memory_limit a 256 MB per impostazione predefinita dalla sua versione 2.6.16, e la variabile PHP_MEMORY_LIMIT la modifica.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.
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:
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:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1: l'esempio del repository pubblica la porta 80 del container senza indirizzo, e Docker la apre allora su tutti gli indirizzi del server. Pubblicata in locale, è raggiungibile solo attraverso il reverse proxy.MYSQL_ROOT_PASSWORD, l'immagine crea il database e il suo utente, poi esegue wallabag:install, che crea le tabelle e l'account wallabag. La riga wallabag is ready! nel log ne segna la fine.wallabag; il servizio db la conserva.wallabag-db contiene il database, wallabag-images le immagini degli articoli. Anche l'esempio della documentazione di installazione usa volumi con nome.redis.2.6.17, 2.6, 2 e latest. Una versione completa vi lascia scegliere il momento di ogni aggiornamento.Per verificare che l'applicazione risponda, interrogate il percorso usato dal controllo di stato dell'immagine:
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.
/var/www/wallabag/data/db/wallabag.sqlite; in questo caso montate un volume su /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, la porta 5432, e POSTGRES_USER e POSTGRES_PASSWORD perché l'immagine crei il database. La versione 2.6.15 dell'immagine corregge la proprietà del database con PostgreSQL 15 e successivi.POPULATE_DATABASE=False, poi inizializzatelo una volta con docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. Il README chiede di eseguire questo comando come nobody, perché nessun file finisca di proprietà di root.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:
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.
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.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag e wallabag.| Variabile | Valore predefinito | Cosa fa |
|---|---|---|
SYMFONY__ENV__SECRET | Una stringa pubblica, la stessa per tutte le istanze | Aggiunge entropia alle operazioni di sicurezza: la documentazione la vuole unica per la vostra istanza |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | L'indirizzo completo della vostra istanza, senza barra finale |
SYMFONY__ENV__FOSUSER_REGISTRATION | false nell'immagine Docker | Apre o chiude la registrazione pubblica |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Invia una e-mail di conferma per ogni registrazione |
SYMFONY__ENV__LOCALE | en | La lingua predefinita dell'istanza, come it |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | Il 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.
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.
X-Forwarded-Proto: il proxy deve inviarla con il valore https.Host: il vostro nome di dominio, perché i reindirizzamenti dell'applicazione puntino a esso.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:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
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:
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
Verificate poi che SYMFONY__ENV__DOMAIN_NAME contenga l'indirizzo in https://, lo stesso del vostro proxy.
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.
| Strumento | Cosa fa | Cosa richiede |
|---|---|---|
| App Android | Sincronizza le vostre liste di articoli e le mostra sul telefono | L'indirizzo dell'istanza, il vostro nome utente e la vostra password; l'app recupera da sola i suoi accessi ai feed |
| App iOS | Mostra i vostri articoli su iPhone e iPad | L'indirizzo, un ID e un segreto di client API, il vostro nome utente e la vostra password |
| Estensione wallabagger, per Firefox e Chrome | Salva la pagina aperta, con i suoi tag, tra i preferiti o in archivio | L'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 segnalibri | Niente: si trascina dalla pagina «Howto» |
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:
| Servizio | Il file da fornire |
|---|---|
| Pocket, esportazione CSV | Lo ZIP di esportazione di Pocket, una volta estratto: un file CSV con un nome come part_000000.csv |
| Pocket, esportazione HTML | Il file HTML della vecchia esportazione di Pocket, come ril_export.html |
| Instapaper | Il CSV della pagina delle impostazioni di Instapaper |
| Omnivore | I file metadata_x_to_y.json dell'esportazione estratta, uno alla volta |
| Pinboard, Delicious | La loro esportazione JSON |
| Shaarli | La sua esportazione HTML |
| Firefox, Chrome | Il backup JSON dei segnalibri di Firefox, o il file Bookmarks di Chrome |
| Readability, elCurator | La loro esportazione |
| wallabag 1.x o 2.x | L'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.
Perché una grande importazione non blocchi la pagina, wallabag la affida a Redis, che il compose.yaml qui sopra prevede già:
1.pocket_csv; smaltisce la coda, poi resta in ascolto finché non lo fermate.docker compose run --rm wallabag import pocket_csv
Gli altri tipi sono pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox e chrome.
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:
- 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
@ diventa %40. Se un carattere codificato impedisce l'avvio, la documentazione suggerisce di raddoppiare il segno di percentuale: %%40.FROM_EMAIL è il mittente di tutte le e-mail di wallabag, TWOFACTOR_SENDER quello dei codici di autenticazione a due fattori. Usate un indirizzo del vostro dominio da cui il vostro server SMTP accetta di inviare.:465 alla fine della riga.Ricreate poi il container con docker compose up -d, e fate una prova con il link «Forgot your password?» della pagina di accesso.
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:
| Elemento | Dove si trova | Come copiarlo |
|---|---|---|
| Le impostazioni | Il vostro compose.yaml: l'immagine ne ricava parameters.yml a ogni avvio | Una copia del file, conservata al sicuro, perché contiene i vostri segreti |
| Il database | Il volume wallabag-db | Un'esportazione con mariadb-dump |
| Le immagini | Il volume wallabag-images, montato su web/assets/images | Un archivio della cartella |
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.
Su una nuova installazione, avviate lo stack con lo stesso compose.yaml, poi ricaricate il database e le immagini:
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.
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:
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, e le sue note di rilascio chiedono di svuotare la vecchia cartella web/uploads/import. In questo compose.yaml, quella cartella si trova dentro il container: quello creato dalla nuova immagine parte senza di essa.make update, che sulle istanze in 2.6.15 o precedenti sceglieva una versione alfa pubblicata quella mattina. Per un'installazione Git rimasta bloccata, le sue note di rilascio danno la soluzione: git checkout 2.6.17 --force, poi make update.make update, che esegue anche le migrazioni e svuota la cache.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.
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.
| Argomento | I nostri team | Voi |
|---|---|---|
| Il server | Aggiornamenti del sistema e della sicurezza, interventi sul server compresi | Il momento più adatto alla vostra attività |
| La supervisione | Server seguito 24 ore su 24, 7 giorni su 7, con intervento senza attendere la vostra chiamata | La lettura dei log della vostra istanza |
| wallabag | Monitoraggio proattivo: errori, rallentamenti, database e spazio su disco individuati, correzione raccomandata | La sua installazione, i suoi aggiornamenti e le sue impostazioni, che applicate voi o il vostro assistente IA |
| Gli account e gli articoli | Il server che li ospita, sorvegliato e salvato | Gli utenti, le registrazioni, i client API e le importazioni |
| I backup | Ogni notte, cifrati e conservati fuori dalla macchina; ripristino compreso | Le esportazioni proprie di wallabag e la richiesta di ripristino, quando ne avete bisogno |
| La migrazione | Il vostro server attuale migrato, in omaggio | Il 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.
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.
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.
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.
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.
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.
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.
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.
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 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.
Simafri
Parliamo del vostro progetto
Diteci in due parole ciò che vi serve: vi rispondiamo rapidamente.
Grazie! La tua richiesta è stata inviata. Ti risponderemo a breve.
Preferite l'email? Scriveteci a support@simafri.com.