Hospedar wallabag em um VPS gerenciado é guardar os artigos que você deixa para ler depois em uma máquina própria, que nossas equipes mantêm atualizada e supervisionam dia e noite. O wallabag é um aplicativo livre de leitura posterior sob a licença MIT. Este guia segue a documentação oficial e a imagem Docker dele, na versão 2.6.17: a instalação com Docker Compose, a primeira conta e os segredos, o HTTPS, os aplicativos e as extensões, a importação do Pocket e de outros serviços, o e-mail, os backups e as atualizações.
Por Simon Vasconcelos Lee
Publicado em 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 reverso em HTTPS.SYMFONY__ENV__SECRET e seu endereço público em SYMFONY__ENV__DOMAIN_NAME; depois troque a senha da conta wallabag, que é wallabag.X-Forwarded-Proto: https: é assim que o wallabag sabe que os visitantes chegam por HTTPS.compose.yaml, e atualize trocando a tag da imagem e executando as migrações.O wallabag é um aplicativo web de leitura posterior: você salva uma página com um clique e a lê quando tiver tempo. O README dele resume assim: clicar, salvar e ler quando quiser. O wallabag extrai o conteúdo do artigo, para que os pop-ups da página original não distraiam você.
O wallabag é publicado sob a licença MIT, copyright Nicolas Lœuillet desde 2013. Ela concede, gratuitamente, o direito de usar, copiar, modificar, mesclar, publicar, distribuir, sublicenciar e vender cópias do software. Você pode, portanto, rodá-lo para você, sua equipe ou seus clientes, sem licença a comprar.
A única condição é manter o aviso de copyright e o texto da licença em todas as cópias ou partes substanciais do software. O texto fornece o software “no estado em que se encontra”, sem garantia.
A documentação do wallabag não traz números de memória ou de CPU. Ela lista, porém, o que o aplicativo exige, e a imagem Docker define alguns valores que ajudam no dimensionamento:
memory_limit em 256 MB por padrão desde a versão 2.6.16 dela, e a variável PHP_MEMORY_LIMIT altera esse valor.O tamanho do servidor depende, portanto, do número de usuários, do volume de artigos e de suas importações. Em um VPS gerenciado, conte-nos como você usa o aplicativo e recomendaremos o tamanho certo.
O repositório wallabag/docker publica a imagem oficial wallabag/wallabag no Docker Hub e no GitHub Container Registry, com um arquivo Compose de exemplo: wallabag, um banco de dados MariaDB e Redis. Em um 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 da primeira inicialização. Strings hexadecimais funcionam em qualquer lugar, inclusive nos comandos SQL que a imagem escreve para criar o banco 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 contêiner sem endereço, e o Docker a abre então em todos os endereços do servidor. Publicada localmente, ela só é acessível pelo proxy reverso.MYSQL_ROOT_PASSWORD, a imagem cria o banco de dados e o usuário dele, depois executa wallabag:install, que cria as tabelas e a conta wallabag. A linha wallabag is ready! no log marca o fim.wallabag; o serviço db a mantém.wallabag-db guarda o banco de dados, wallabag-images as imagens dos artigos. O exemplo da documentação de instalação também usa volumes nomeados.redis.2.6.17, 2.6, 2 e latest. Uma versão completa permite escolher o momento de cada atualização.Para verificar se o aplicativo responde, consulte a rota usada pela verificação de saúde da imagem:
curl http://127.0.0.1:8080/api/info
A imagem relê as variáveis SYMFONY__ENV__* a cada inicialização do contêiner e limpa o cache. Depois de alterar o compose.yaml, um docker compose up -d recria o contêiner e aplica as novas configuraçõ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 o banco de dados. A versão 2.6.15 da imagem corrige a propriedade do banco de dados com o PostgreSQL 15 e posteriores.POPULATE_DATABASE=False e depois inicialize-o uma vez com docker compose exec --user nobody wallabag php bin/console wallabag:install --env=prod -n. O README pede para rodar esse comando como nobody, para que nenhum arquivo fique pertencendo ao root.O caminho que a documentação recomenda em um servidor dedicado é o repositório Git e o Makefile dele, 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 de hosts virtuais traz configurações para Nginx, Apache, Caddy e lighttpd. Os exemplos dela servem o wallabag na raiz de um domínio ou subdomínio, a configuração suportada pelos mantenedores.
A instalação cria uma conta de administrador cujo nome de usuário e senha são ambos wallabag, com o endereço wallabag@wallabag.io. Troque-os antes de abrir a instância ao público. Um túnel SSH leva a porta 8080 do servidor para seu computador, em http://localhost:8080; acrescente -p e a porta SSH indicada em sua área de cliente.
ssh -L 8080:127.0.0.1:8080 user@read.example.com
wallabag e wallabag.| Variável | Valor padrão | O que faz |
|---|---|---|
SYMFONY__ENV__SECRET | Uma string pública, a mesma para todas as instâncias | Acrescenta entropia às operações de segurança: a documentação quer que ela seja única para sua instância |
SYMFONY__ENV__DOMAIN_NAME | https://your-wallabag-instance.wallabag.org | O endereço completo de sua instância, sem barra final |
SYMFONY__ENV__FOSUSER_REGISTRATION | false na imagem Docker | Abre ou fecha o cadastro público |
SYMFONY__ENV__FOSUSER_CONFIRMATION | true | Envia um e-mail de confirmação a cada cadastro |
SYMFONY__ENV__LOCALE | en | O idioma padrão da instância, como pt |
SYMFONY__ENV__SERVER_NAME | Your wallabag instance | O nome da instância exibido em seu aplicativo de autenticação de dois fatores |
Com a imagem Docker, o cadastro público fica, portanto, fechado. Para abrir a instância para sua equipe, crie você mesmo as contas em “Users management”, ou abra o cadastro enquanto as pessoas se inscrevem, com confirmação por e-mail.
As configurações mais sensíveis ficam em “Internal Settings”, reservadas ao administrador da instância: o compartilhamento público de artigos, os formatos de exportação, o login em sites pagos, o download local das imagens e as importações em segundo plano.
O contêiner serve o wallabag em HTTP, na porta 80 dele, por meio de um Nginx interno. O HTTPS fica a cargo do proxy reverso colocado na frente. Esse Nginx interno lê o cabeçalho X-Forwarded-Proto: quando ele vale https, informa ao PHP que a requisição é criptografada, e o wallabag monta os links e os cookies de acordo.
X-Forwarded-Proto: o proxy deve enviá-lo com o valor https.Host: seu nome de domínio, para que os redirecionamentos do aplicativo apontem para ele.O Caddy obtém sozinho o certificado Let’s Encrypt e o renova. A diretiva reverse_proxy dele mantém o cabeçalho Host e acrescenta por padrã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 configurar 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
Depois, verifique se SYMFONY__ENV__DOMAIN_NAME contém o endereço em https://, o mesmo de seu proxy.
O wallabag funciona no navegador, e o projeto também publica aplicativos e uma extensão, que se conectam a sua instância pelo endereço dela, sem barra final.
| Ferramenta | O que faz | Do que precisa |
|---|---|---|
| Aplicativo Android | Sincroniza suas listas de artigos e as exibe no celular | O endereço da instância, seu nome de usuário e sua senha; o aplicativo obtém sozinho os acessos aos feeds |
| Aplicativo iOS | Exibe seus artigos no iPhone e no iPad | O endereço, um ID e um segredo de cliente da API, seu nome de usuário e sua senha |
| Extensão wallabagger, para Firefox e Chrome | Salva a página aberta, com as tags dela, como favorita ou arquivada | O endereço, um ID e um segredo de cliente da API, seu nome de usuário e sua senha |
| Bookmarklet “bag it!” | Salva a página aberta pela barra de favoritos | Nada: basta arrastá-lo da página “Howto” |
O menu “Import” traz seus artigos de outro serviço. O wallabag busca de novo o conteúdo de cada artigo, o que leva tempo em uma exportação grande. Os importadores da versão 2.6.17:
| Serviço | O arquivo a fornecer |
|---|---|
| Pocket, exportação CSV | O ZIP de exportação do Pocket, depois de extraído: um arquivo CSV com um nome como part_000000.csv |
| Pocket, exportação HTML | O arquivo HTML da exportação antiga do Pocket, como ril_export.html |
| Instapaper | O CSV da página de configurações do Instapaper |
| Omnivore | Os arquivos metadata_x_to_y.json da exportação extraída, um de cada vez |
| Pinboard, Delicious | A exportação JSON deles |
| Shaarli | A exportação HTML dele |
| Firefox, Chrome | O backup JSON dos favoritos do Firefox, ou o arquivo Bookmarks do Chrome |
| Readability, elCurator | A exportação deles |
| wallabag 1.x ou 2.x | A exportação JSON de outra instância |
A versão 2.6.17 também traz uma correção na importação CSV do Pocket. Existe ainda a importação pela API do Pocket, com uma chave de desenvolvedor que o administrador define na configuração.
Para que uma grande importação não trave a página, o wallabag a entrega ao Redis, que o compose.yaml acima já prevê:
1.pocket_csv; ele processa a fila e depois continua aguardando até você pará-lo.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 cadastro, a redefinição de senha e os códigos de dois fatores por e-mail. Ele os envia pelo servidor descrito em SYMFONY__ENV__MAILER_DSN, que por padrão é smtp://127.0.0.1.
Em um VPS Simafri, configure um servidor SMTP autenticado, na porta 587 ou 465: o serviço de e-mail de seu domínio, ou um serviço de envio. A documentação dá o formato em uma só linha, com usuário, senha, 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
@ vira %40. Se um caractere codificado impedir a inicialização, a documentação sugere dobrar o sinal de porcentagem: %%40.FROM_EMAIL é o remetente de todos os e-mails do wallabag, TWOFACTOR_SENDER o dos códigos de dois fatores. Use um endereço de seu domínio que seu servidor SMTP aceite como remetente.:465 no fim da linha.Depois, recrie o contêiner com docker compose up -d, e teste com o link “Forgot your password?” da página de login.
A página de backups da documentação cita três itens: as configurações, o banco de dados e as imagens. Com a imagem Docker, veja onde cada um fica:
| Item | Onde fica | Como copiá-lo |
|---|---|---|
| As configurações | Seu compose.yaml: a imagem gera a partir dele o parameters.yml a cada inicialização | Uma cópia do arquivo, guardada em lugar seguro, já que contém seus segredos |
| O banco 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 compactado 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
Agende essas cópias e envie-as para fora do servidor. Guardados no disco dele, esses arquivos também entram nos backups noturnos do servidor. Com SQLite, a documentação pede para copiar a pasta data/db.
Em uma instalação nova, inicie o conjunto com o mesmo compose.yaml e depois carregue de volta o banco 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 usuário também pode exportar os próprios artigos em JSON, pela lista “All entries”, e importá-los de novo em outra instância com o importador wallabag 2.x. Para os administradores, o comando wallabag:export exporta para um arquivo os artigos de um usuário.
Com Docker, troque a tag da imagem no compose.yaml, faça um backup, depois baixe a nova imagem e recrie o contêiner. O README pede então para executar as migrações do banco 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 as notas da versão pedem para esvaziar a antiga pasta web/uploads/import. Neste compose.yaml, essa pasta fica dentro do contêiner: o que é criado a partir da nova imagem começa sem ela.make update, que, nas instâncias em 2.6.15 ou anteriores, escolhia uma versão alfa publicada naquela manhã. Para uma instalação Git que tenha travado, as notas da versão dão o reparo: git checkout 2.6.17 --force e depois make update.make update, que também executa as migrações e limpa o cache.Leia as notas de cada versão antes de atualizar: elas indicam as etapas próprias daquela versão, como a pasta a esvaziar na 2.6.16.
A auto-hospedagem exige cuidar do servidor além da aplicação. Em um VPS gerenciado, nossas equipes assumem o servidor e acompanham sua instância de forma proativa; o wallabag continua sendo seu software, com as configurações dele e seus artigos.
| Assunto | Nossas equipes | Você |
|---|---|---|
| O servidor | Atualizações do sistema e de segurança, com intervenções no servidor incluídas | O momento que convém a sua atividade |
| A supervisão | Servidor acompanhado 24 horas por dia, 7 dias por semana, com intervenção sem esperar sua ligação | A leitura dos logs de sua instância |
| wallabag | Acompanhamento proativo: erros, lentidões, banco de dados e espaço em disco identificados, correção recomendada | A instalação, as atualizações e as configurações dele, que você aplica, por conta própria ou com seu assistente de IA |
| As contas e os artigos | O servidor que os sustenta, monitorado e com backup | Os usuários, os cadastros, os clientes da API e as importações |
| Os backups | Toda noite, criptografados e guardados fora da máquina; restauração incluída | As exportações próprias do wallabag e o pedido de restauração, quando você precisar |
| A migração | Seu servidor atual migrado, grátis | O momento da virada |
Se você preferir que nossas equipes intervenham na própria aplicação, esse serviço é cobrado por hora ou por valor fechado, com o orçamento informado antes da intervenção.
Com um VPS gerenciado Simafri, nossas equipes mantêm atualizado o servidor de sua instância wallabag, monitoram-no dia e noite e intervêm sem esperar sua ligação; elas também acompanham sua instância de forma proativa e recomendam as correções úteis, que você aplica por conta própria ou com seu assistente de IA. Os backups são criptografados todas as noites e guardados fora da máquina, a restauração está incluída, e a migração de seu servidor atual é grátis.
Sim. O wallabag está sob a licença MIT: você pode usá-lo, modificá-lo e redistribuí-lo, em uma empresa ou em qualquer outro lugar, sem licença a comprar, desde que mantenha o aviso de copyright dele. Resta o custo do servidor em que ele roda.
Parta do compose.yaml de exemplo da imagem wallabag/wallabag, com MariaDB e Redis. Defina SYMFONY__ENV__SECRET, as senhas e seu endereço em SYMFONY__ENV__DOMAIN_NAME, publique a porta em 127.0.0.1, depois execute docker compose up -d e coloque na frente um proxy reverso em HTTPS.
A instalação cria um administrador cujo nome de usuário e senha são ambos wallabag. Troque a senha em Config, aba 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: ele contém um arquivo CSV como part_000000.csv. No menu Import, escolha Pocket CSV e envie esse arquivo. O wallabag busca então o conteúdo de cada artigo; para uma exportação grande, ative o Redis nas configurações internas.
O projeto publica aplicativos para Android e iOS e a extensão wallabagger para Firefox e Chrome, que se conectam a sua instância pelo endereço dela, 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 a requisição chega por HTTPS. Faça seu proxy enviá-lo com o valor https, junto com o cabeçalho Host de seu domínio, e coloque o endereço em https:// em SYMFONY__ENV__DOMAIN_NAME.
Copie três itens: o banco de dados, com mariadb-dump no caso do MariaDB, o volume de imagens montado em web/assets/images, e seu compose.yaml, que contém as configurações e os segredos. Envie essas cópias para fora do servidor.
Um VPS gerenciado cobre o servidor: sistema, segurança, supervisão e backups. Nossas equipes também acompanham sua instância de forma proativa e recomendam as correções úteis, que você aplica. Uma intervenção na aplicação é cobrada por hora ou por valor fechado.
Simafri
Vamos falar de seu site
Conte para a gente sobre seu projeto em poucas palavras: responderemos rapidamente.
Obrigado! O seu pedido foi enviado. Responderemos em breve.
Prefere o e-mail? Escreva para a gente em support@simafri.com.