Hospedar wallabag em um VPS gerenciado: sua lista de leitura em seu servidor

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.

Simon Vasconcelos Lee Por Publicado em 18 de novembro de 2026Leitura: 14 minutos

Todos os guias

O essencial

  1. A licença MIT permite usar, modificar e redistribuir o wallabag livremente, em uma empresa ou em qualquer outro lugar, desde que você mantenha o aviso de copyright dele.
  2. Instale-o com Docker Compose: a imagem oficial wallabag/wallabag, MariaDB, Redis e a porta web publicada em 127.0.0.1 atrás de um proxy reverso em HTTPS.
  3. Antes da primeira inicialização, defina SYMFONY__ENV__SECRET e seu endereço público em SYMFONY__ENV__DOMAIN_NAME; depois troque a senha da conta wallabag, que é wallabag.
  4. O proxy reverso envia X-Forwarded-Proto: https: é assim que o wallabag sabe que os visitantes chegam por HTTPS.
  5. Faça backup do banco de dados, do volume de imagens e de seu compose.yaml, e atualize trocando a tag da imagem e executando as migrações.

O que o wallabag faz

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 que a licença MIT permite

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.

Os recursos a prever

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:

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.

A instalação com Docker Compose

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:

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:

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:

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

Para verificar se o aplicativo responde, consulte a rota usada pela verificação de saúde da imagem:

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

Com SQLite ou PostgreSQL

Sem Docker

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:

Terminal
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 primeira conta, os segredos e os cadastros

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.

Terminal, em seu computador
ssh -L 8080:127.0.0.1:8080 user@read.example.com
  1. Entre com wallabag e wallabag.
  2. Em “Config”, aba “Password”, escolha uma nova senha de pelo menos 8 caracteres.
  3. Na aba “User information”, substitua o endereço de e-mail por seu: é ele que recebe os links de redefinição de senha.
  4. Na mesma aba, ative a autenticação de dois fatores. A documentação recomenda um aplicativo de códigos de uso único, como o FreeOTP, em vez do código enviado por e-mail; o wallabag também oferece códigos de backup.
VariávelValor padrãoO que faz
SYMFONY__ENV__SECRETUma string pública, a mesma para todas as instânciasAcrescenta entropia às operações de segurança: a documentação quer que ela seja única para sua instância
SYMFONY__ENV__DOMAIN_NAMEhttps://your-wallabag-instance.wallabag.orgO endereço completo de sua instância, sem barra final
SYMFONY__ENV__FOSUSER_REGISTRATIONfalse na imagem DockerAbre ou fecha o cadastro público
SYMFONY__ENV__FOSUSER_CONFIRMATIONtrueEnvia um e-mail de confirmação a cada cadastro
SYMFONY__ENV__LOCALEenO idioma padrão da instância, como pt
SYMFONY__ENV__SERVER_NAMEYour wallabag instanceO 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.

HTTPS: o proxy reverso

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.

Com o Caddy

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:

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

Com o Nginx

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:

Bloco do 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;
    }
}
Terminal
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.

Os aplicativos, as extensões e os feeds RSS

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.

FerramentaO que fazDo que precisa
Aplicativo AndroidSincroniza suas listas de artigos e as exibe no celularO endereço da instância, seu nome de usuário e sua senha; o aplicativo obtém sozinho os acessos aos feeds
Aplicativo iOSExibe seus artigos no iPhone e no iPadO 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 ChromeSalva a página aberta, com as tags dela, como favorita ou arquivadaO 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 favoritosNada: basta arrastá-lo da página “Howto”

Importar seus artigos do Pocket e de outros serviços

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çoO arquivo a fornecer
Pocket, exportação CSVO ZIP de exportação do Pocket, depois de extraído: um arquivo CSV com um nome como part_000000.csv
Pocket, exportação HTMLO arquivo HTML da exportação antiga do Pocket, como ril_export.html
InstapaperO CSV da página de configurações do Instapaper
OmnivoreOs arquivos metadata_x_to_y.json da exportação extraída, um de cada vez
Pinboard, DeliciousA exportação JSON deles
ShaarliA exportação HTML dele
Firefox, ChromeO backup JSON dos favoritos do Firefox, ou o arquivo Bookmarks do Chrome
Readability, elCuratorA exportação deles
wallabag 1.x ou 2.xA 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.

As grandes importações em segundo plano

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. Em “Internal Settings”, seção “Import”, ative o Redis com o valor 1.
  2. Inicie a importação pelo menu “Import”: o wallabag coloca os artigos em uma fila.
  3. Inicie o worker do tipo de importação escolhido, por exemplo pocket_csv; ele processa a fila e depois continua aguardando até você pará-lo.
Terminal, na pasta do compose.yaml
docker compose run --rm wallabag import pocket_csv

Os outros tipos são pocket, readability, instapaper, wallabag_v1, wallabag_v2, firefox e chrome.

O e-mail: a configuração SMTP

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:

compose.yaml, serviço 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

Depois, recrie o contêiner com docker compose up -d, e teste com o link “Forgot your password?” da página de login.

Os backups

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:

ItemOnde ficaComo copiá-lo
As configuraçõesSeu compose.yaml: a imagem gera a partir dele o parameters.yml a cada inicializaçãoUma cópia do arquivo, guardada em lugar seguro, já que contém seus segredos
O banco de dadosO volume wallabag-dbUma exportação com mariadb-dump
As imagensO volume wallabag-images, montado em web/assets/imagesUm arquivo compactado da pasta
Terminal, na pasta do 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

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.

A restauração

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:

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

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.

As atualizações

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:

Terminal, na pasta do 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

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.

Quem faz o quê em um VPS gerenciado

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.

AssuntoNossas equipesVocê
O servidorAtualizações do sistema e de segurança, com intervenções no servidor incluídasO momento que convém a sua atividade
A supervisãoServidor acompanhado 24 horas por dia, 7 dias por semana, com intervenção sem esperar sua ligaçãoA leitura dos logs de sua instância
wallabagAcompanhamento proativo: erros, lentidões, banco de dados e espaço em disco identificados, correção recomendadaA 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 artigosO servidor que os sustenta, monitorado e com backupOs usuários, os cadastros, os clientes da API e as importações
Os backupsToda noite, criptografados e guardados fora da máquina; restauração incluídaAs exportações próprias do wallabag e o pedido de restauração, quando você precisar
A migraçãoSeu servidor atual migrado, grátisO 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.

wallabag, em um servidor cuidado por nós

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.

Conhecer os VPS gerenciados

Perguntas frequentes

O wallabag é gratuito?

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.

Como instalar o wallabag com Docker Compose?

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.

Quais são os acessos padrão do wallabag?

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.

Como importar meus artigos do Pocket para o wallabag?

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.

Quais aplicativos funcionam com o wallabag?

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.

Por que os links do wallabag ficam em http atrás de um proxy?

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.

Como fazer backup do wallabag?

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 wallabag?

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.

Fontes e documentação oficial

Guias relacionados

Hospedar FreshRSS em um VPS gerenciado: seus feeds RSS em seu servidorHospedar o FreshRSS em um VPS gerenciado é ler seus feeds RSS, você e sua equipe, a partir de uma máquina própria, que nossas equipes mantêm atualizada e supervisionam dia e noite. O FreshRSS é um software livre sob a licença AGPL-3.0. Este guia segue a documentação oficial dele: a instalação com Docker Compose, o HTTPS, a atualização dos feeds, as contas e o login, a API para os aplicativos de celular, o banco de dados, os backups e as atualizações.Backup de VPS: o que verificar antes de contratarUma oferta de VPS quase sempre anuncia “backup incluído”. Por trás dessas duas palavras, pode haver uma cópia toda noite, guardada fora da máquina e restaurada por especialistas, ou um snapshot no mesmo disco do servidor. Este guia traz as perguntas que fazem a diferença, o que cada resposta quer dizer e como verificar que um backup realmente se restaura.Diferença entre VPS gerenciado e não gerenciado: quem faz o quêA diferença entre um VPS gerenciado e um VPS não gerenciado se resume a uma pergunta: quem cuida do servidor depois que ele está no ar. A palavra “gerenciado”, porém, não tem definição oficial: de um provedor para outro, ela vai de uma simples instalação do sistema até a operação completa do servidor. Este guia mostra quem faz o quê, linha por linha, incluindo o nível intermediário da assistência, e traz as perguntas que tiram a dúvida antes de assinar.
Entre em contato