Alojar wallabag num VPS gerido é guardar os artigos que deixa para ler mais tarde numa máquina sua, que as nossas equipas mantêm atualizada e supervisionam dia e noite. O wallabag é uma aplicação livre de leitura diferida sob licença MIT. Este guia segue a sua documentação oficial e a sua imagem Docker, na versão 2.6.17: a instalação com o Docker Compose, a primeira conta e os segredos, o HTTPS, as aplicações e as extensões, a importação do Pocket e de outros serviços, o e-mail, as cópias de segurança e as atualizações.
Por Simon Vasconcelos Lee
Publicado a 18 de novembro de 2026Leitura: 14 minutos
wallabag/wallabag, MariaDB, Redis e a porta web publicada em 127.0.0.1 atrás de um proxy inverso em HTTPS.SYMFONY__ENV__SECRET e o seu endereço público em SYMFONY__ENV__DOMAIN_NAME; depois altere a palavra-passe da conta wallabag, que é wallabag.X-Forwarded-Proto: https: é assim que o wallabag sabe que os seus visitantes chegam por HTTPS.compose.yaml, e atualize alterando a etiqueta da imagem e executando as migrações.O wallabag é uma aplicação web de leitura diferida: guarda uma página com um clique e lê-a quando tiver tempo. O seu README resume-o assim: clicar, guardar e ler quando quiser. O wallabag extrai o conteúdo do artigo, para que as janelas pop-up da página original não o distraiam.
O wallabag é publicado sob a licença MIT, copyright Nicolas Lœuillet desde 2013. Concede, gratuitamente, o direito de utilizar, copiar, modificar, fundir, publicar, distribuir, sublicenciar e vender cópias do software. Pode, portanto, executá-lo para si, para a sua equipa ou para os seus clientes, sem licença para comprar.
A única condição é manter o aviso de direitos de autor e o texto da licença em todas as cópias ou partes substanciais do software. O texto fornece o software «tal como está», sem garantia.
A documentação do wallabag não indica valores de memória nem de processador. Enumera, no entanto, aquilo de que a aplicação precisa, e a imagem Docker fixa alguns valores que ajudam no dimensionamento:
memory_limit em 256 MB por omissão desde a sua versão 2.6.16, e a variável PHP_MEMORY_LIMIT altera-o.O tamanho do servidor depende, portanto, do número de utilizadores, do volume de artigos e das suas importações. Num VPS gerido, descreva-nos a sua utilização e recomendamos-lhe o tamanho adequado.
O repositório wallabag/docker publica a imagem oficial wallabag/wallabag no Docker Hub e no GitHub Container Registry, com um ficheiro Compose de exemplo: wallabag, uma base de dados MariaDB e Redis. Num servidor com o Docker instalado, crie uma pasta e coloque nela este compose.yaml, baseado nesse exemplo:
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:
Substitua os três valores secretos antes do primeiro arranque. As cadeias hexadecimais funcionam em todo o lado, incluindo nos comandos SQL que a imagem escreve para criar a base de dados:
openssl rand -hex 32
docker compose up -d
docker compose logs -f wallabag
127.0.0.1: o exemplo do repositório publica a porta 80 do contentor sem endereço, e o Docker abre-a então em todos os endereços do servidor. Publicada localmente, só é acessível através do proxy inverso.MYSQL_ROOT_PASSWORD, a imagem cria a base de dados e o respetivo utilizador, e depois executa wallabag:install, que cria as tabelas e a conta wallabag. A linha wallabag is ready! no registo marca o fim.wallabag; o serviço db mantém-na.wallabag-db contém a base de dados, wallabag-images as imagens dos artigos. O exemplo da documentação de instalação também usa volumes com nome.redis.2.6.17, 2.6, 2 e latest. Uma versão completa permite-lhe escolher o momento de cada atualização.Para verificar que a aplicação responde, consulte a rota utilizada pela verificação de estado da imagem:
curl http://127.0.0.1:8080/api/info
A imagem volta a ler as variáveis SYMFONY__ENV__* em cada arranque do contentor e limpa a cache. Depois de alterar o compose.yaml, um docker compose up -d recria o contentor e aplica as novas definições.
/var/www/wallabag/data/db/wallabag.sqlite; nesse caso, monte um volume em /var/www/wallabag/data.SYMFONY__ENV__DATABASE_DRIVER=pdo_pgsql, a porta 5432, e POSTGRES_USER e POSTGRES_PASSWORD para que a imagem crie a base de dados. A versão 2.6.15 da imagem corrige a propriedade da base de dados com o PostgreSQL 15 e posteriores.POPULATE_DATABASE=False e depois inicialize-a uma vez com docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. O README pede para executar este comando como nobody, para que nenhum ficheiro fique a pertencer a root.A via que a documentação recomenda num servidor dedicado é o repositório Git e o seu Makefile, com o Composer, a ferramenta make e as extensões PHP da página de requisitos:
git clone https://github.com/wallabag/wallabag.git
cd wallabag && make install
O servidor web serve então a pasta web, com app.php como ponto de entrada: a página dos anfitriões virtuais dá configurações para Nginx, Apache, Caddy e lighttpd. Os seus exemplos servem o wallabag na raiz de um domínio ou subdomínio, a configuração suportada pelos responsáveis do projeto.
A instalação cria uma conta de administrador cujo nome de utilizador e palavra-passe são ambos wallabag, com o endereço wallabag@wallabag.io. Altere-os antes de abrir a instância ao público. Um túnel SSH traz a porta 8080 do servidor para o seu computador, em http://localhost:8080; acrescente -p e a porta SSH indicada na sua área de cliente.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag e wallabag.| Variável | Valor por omissão | O que faz |
|---|---|---|
SYMFONY__ENV__SECRET | Uma cadeia pública, a mesma para todas as instâncias | Acrescenta entropia às operações de segurança: a documentação quer que seja única para a sua instância |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | O endereço completo da sua instância, sem barra final |
SYMFONY__ENV__FOSUSER_REGISTRATION | false na imagem Docker | Abre ou fecha o registo público |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Envia um e-mail de confirmação para cada registo |
SYMFONY__ENV__LOCALE | en | A língua por omissão da instância, como pt |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | O nome da instância apresentado na sua aplicação de autenticação de dois fatores |
Com a imagem Docker, o registo público está, portanto, fechado. Para abrir a instância à sua equipa, crie as contas a partir de «Users management», ou abra o registo durante o tempo em que as pessoas se inscrevem, com confirmação por e-mail.
As definições mais sensíveis estão em «Internal Settings», reservadas ao administrador da instância: a partilha pública de artigos, os formatos de exportação, o início de sessão em sites pagos, a descarga local das imagens e as importações em segundo plano.
O contentor serve o wallabag em HTTP, na sua porta 80, através de um Nginx interno. O HTTPS fica a cargo do proxy inverso colocado à frente. Esse Nginx interno lê o cabeçalho X-Forwarded-Proto: quando vale https, indica ao PHP que o pedido é cifrado, e o wallabag constrói as suas ligações e os seus cookies em conformidade.
X-Forwarded-Proto: o proxy deve enviá-lo com o valor https.Host: o seu nome de domínio, para que os redirecionamentos da aplicação apontem para ele.O Caddy obtém por si próprio o certificado Let’s Encrypt e renova-o. A sua diretiva reverse_proxy mantém o cabeçalho Host e acrescenta por omissão X-Forwarded-For, X-Forwarded-Proto e X-Forwarded-Host:
read.example.com {
reverse_proxy 127.0.0.1:8080
}
Este bloco retoma os cabeçalhos do exemplo Nginx do README da imagem Docker, acrescenta o cabeçalho Host e o limite de envio da imagem, e escuta na porta 80 para que o Certbot possa instalar o 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
Verifique depois que SYMFONY__ENV__DOMAIN_NAME contém o endereço em https://, o mesmo que o do seu proxy.
O wallabag funciona no navegador, e o projeto publica também aplicações e uma extensão, que se ligam à sua instância pelo respetivo endereço, sem barra final.
| Ferramenta | O que faz | Do que precisa |
|---|---|---|
| Aplicação Android | Sincroniza as suas listas de artigos e mostra-as no telemóvel | O endereço da instância, o seu nome de utilizador e a sua palavra-passe; a aplicação obtém sozinha os seus acessos aos feeds |
| Aplicação iOS | Mostra os seus artigos no iPhone e no iPad | O endereço, um identificador e um segredo de cliente da API, o seu nome de utilizador e a sua palavra-passe |
| Extensão wallabagger, para Firefox e Chrome | Guarda a página aberta, com as suas etiquetas, como favorita ou arquivada | O endereço, um identificador e um segredo de cliente da API, o seu nome de utilizador e a sua palavra-passe |
| Marcador «bag it!» | Guarda a página aberta a partir da barra de marcadores | Nada: arrasta-se a partir da página «Howto» |
O menu «Import» traz os seus artigos de outro serviço. O wallabag volta a obter o conteúdo de cada artigo, o que leva tempo com uma exportação volumosa. Os importadores da versão 2.6.17:
| Serviço | O ficheiro a fornecer |
|---|---|
| Pocket, exportação CSV | O ZIP de exportação do Pocket, depois de extraído: um ficheiro CSV com um nome como part_000000.csv |
| Pocket, exportação HTML | O ficheiro HTML da exportação antiga do Pocket, como ril_export.html |
| Instapaper | O CSV da página de definições do Instapaper |
| Omnivore | Os ficheiros metadata_x_to_y.json da exportação extraída, um de cada vez |
| Pinboard, Delicious | A respetiva exportação JSON |
| Shaarli | A sua exportação HTML |
| Firefox, Chrome | A cópia de segurança JSON dos marcadores do Firefox, ou o ficheiro Bookmarks do Chrome |
| Readability, elCurator | A respetiva exportação |
| wallabag 1.x ou 2.x | A exportação JSON de outra instância |
A versão 2.6.17 traz ainda uma correção à importação CSV do Pocket. Existe também a importação através da API do Pocket, com uma chave de programador que o administrador define na configuração.
Para que uma grande importação não bloqueie a página, o wallabag confia-a ao Redis, que o compose.yaml acima já prevê:
1.pocket_csv; esvazia a fila e depois continua à escuta até o parar.docker compose run --rm wallabag import pocket_csv
Os outros tipos são pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox e chrome.
O wallabag envia e-mails para a confirmação de registos, a reposição de palavras-passe e os códigos de autenticação de dois fatores por e-mail. Envia-os através do servidor descrito por SYMFONY__ENV__MAILER_DSN, que por omissão é smtp://127.0.0.1.
Num VPS Simafri, configure um servidor SMTP autenticado, na porta 587 ou 465: o serviço de correio do seu domínio, ou um serviço de envio. A documentação dá o formato numa só linha, com utilizador, palavra-passe, servidor 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
@ passa a %40. Se um carácter codificado impedir o arranque, a documentação sugere duplicar o sinal de percentagem: %%40.FROM_EMAIL é o remetente de todos os e-mails do wallabag, TWOFACTOR_SENDER o dos códigos de autenticação de dois fatores. Use um endereço do seu domínio a partir do qual o seu servidor SMTP aceite enviar.:465 no fim da linha.Recrie depois o contentor com docker compose up -d, e faça um teste com a ligação «Forgot your password?» da página de início de sessão.
A página de cópias de segurança da documentação indica três elementos: as definições, a base de dados e as imagens. Com a imagem Docker, eis onde se encontra cada um:
| Elemento | Onde se encontra | Como copiá-lo |
|---|---|---|
| As definições | O seu compose.yaml: a imagem gera a partir dele parameters.yml em cada arranque | Uma cópia do ficheiro, guardada em segurança, porque contém os seus segredos |
| A base de dados | O volume wallabag-db | Uma exportação com mariadb-dump |
| As imagens | O volume wallabag-images, montado em web/assets/images | Um arquivo da pasta |
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
Programe estas cópias e envie-as para fora do servidor. Guardados no seu disco, estes arquivos entram também nas cópias de segurança noturnas do servidor. Com SQLite, a documentação pede para copiar a pasta data/db.
Numa instalação nova, arranque o conjunto com o mesmo compose.yaml e depois volte a carregar a base de dados e as imagens:
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
Cada utilizador pode também exportar os seus artigos em JSON, a partir da lista «All entries», e importá-los de novo noutra instância com o importador wallabag 2.x. Para os administradores, o comando wallabag:export exporta para um ficheiro os artigos de um utilizador.
Com o Docker, altere a etiqueta da imagem no compose.yaml, faça uma cópia de segurança, e depois obtenha a nova imagem e recrie o contentor. O README pede então para executar as migrações da base de dados quando uma versão as traz:
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 a sua nota de versão pede para esvaziar a antiga pasta web/uploads/import. Neste compose.yaml, essa pasta fica dentro do contentor: o que é criado a partir da nova imagem arranca sem ela.make update, que nas instâncias em 2.6.15 ou anteriores escolhia uma versão alfa publicada nessa manhã. Para uma instalação Git que tenha ficado bloqueada, a sua nota de versão dá a reparação: git checkout 2.6.17 --force e depois make update.make update, que executa também as migrações e limpa a cache.Leia a nota de cada versão antes de atualizar: assinala os passos próprios dessa versão, como a pasta a esvaziar na 2.6.16.
O autoalojamento exige cuidar do servidor para além da aplicação. Num VPS gerido, as nossas equipas assumem o servidor e acompanham a sua instância de forma proativa; o wallabag continua a ser o seu software, com as suas definições e os seus artigos.
| Assunto | As nossas equipas | Você |
|---|---|---|
| O servidor | Atualizações do sistema e de segurança, intervenções no servidor incluídas | O momento que convém à sua atividade |
| A supervisão | Servidor acompanhado 24 horas por dia, 7 dias por semana, com intervenção sem esperar pela sua chamada | A leitura dos registos da sua instância |
| wallabag | Acompanhamento proativo: erros, lentidão, base de dados e espaço em disco identificados, correção recomendada | A sua instalação, as suas atualizações e as suas definições, que aplica diretamente ou com o seu assistente de IA |
| As contas e os artigos | O servidor que os suporta, vigiado e com cópias de segurança | Os utilizadores, os registos, os clientes da API e as importações |
| As cópias de segurança | Todas as noites, cifradas e guardadas fora da máquina; restauro incluído | As exportações próprias do wallabag e o pedido de restauro, quando precisar |
| A migração | O seu servidor atual migrado, oferecido | O momento da mudança |
Se preferir que as nossas equipas intervenham na própria aplicação, este serviço é faturado à hora ou por pacote, com um orçamento comunicado antes da intervenção.
Com um VPS gerido da Simafri, as nossas equipas mantêm atualizado o servidor da sua instância wallabag, vigiam-no dia e noite e intervêm sem esperar pela sua chamada; acompanham também a sua instância de forma proativa e recomendam-lhe as correções úteis, que aplica diretamente ou com o seu assistente de IA. As cópias de segurança são cifradas todas as noites e guardadas fora da máquina, o seu restauro está incluído, e a migração do seu servidor atual é oferecida.
Sim. O wallabag está sob licença MIT: pode utilizá-lo, modificá-lo e redistribuí-lo, numa empresa como em qualquer outro lado, sem licença para comprar, desde que mantenha o seu aviso de direitos de autor. Resta o custo do servidor que o faz funcionar.
Parta do compose.yaml de exemplo da imagem wallabag/wallabag, com MariaDB e Redis. Defina SYMFONY__ENV__SECRET, as palavras-passe e o seu endereço em SYMFONY__ENV__DOMAIN_NAME, publique a porta em 127.0.0.1, execute docker compose up -d e coloque à frente um proxy inverso em HTTPS.
A instalação cria um administrador cujo nome de utilizador e palavra-passe são ambos wallabag. Altere a palavra-passe em Config, separador Password, e o endereço de e-mail em User information, antes de abrir a instância ao público.
Extraia o ZIP de exportação do Pocket: contém um ficheiro CSV como part_000000.csv. No menu Import, escolha Pocket CSV e envie esse ficheiro. O wallabag obtém então o conteúdo de cada artigo; para uma exportação volumosa, ative o Redis nas definições internas.
O projeto publica aplicações para Android e iOS e a extensão wallabagger para Firefox e Chrome, que se ligam à sua instância pelo respetivo endereço, sem barra final. O iOS e o wallabagger precisam de um cliente da API, criado em API clients management.
A imagem lê o cabeçalho X-Forwarded-Proto para saber que o pedido chega por HTTPS. Faça com que o seu proxy o envie com o valor https, juntamente com o cabeçalho Host do seu domínio, e coloque o endereço em https:// em SYMFONY__ENV__DOMAIN_NAME.
Copie três elementos: a base de dados, com mariadb-dump para o MariaDB, o volume das imagens montado em web/assets/images, e o seu compose.yaml, que contém as definições e os segredos. Envie estas cópias para fora do servidor.
Um VPS gerido cobre o servidor: sistema, segurança, supervisão e cópias de segurança. As nossas equipas acompanham também a sua instância de forma proativa e recomendam-lhe as correções úteis, que aplica. Uma intervenção na aplicação é faturada à hora ou por pacote.
Simafri
Vamos falar do seu projeto
Diga-nos em poucas palavras o que precisa: respondemos-lhe rapidamente.
Obrigado! O seu pedido foi enviado. Responderemos em breve.
Prefere o email? Escreva-nos para support@simafri.com.