Alojar wallabag num VPS gerido: as suas leituras para depois no seu servidor

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.

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

Todos os guias

O essencial

  1. A licença MIT permite utilizar, modificar e redistribuir livremente o wallabag, numa empresa como em qualquer outro lado, desde que mantenha o seu aviso de direitos de autor.
  2. Instale-o com o Docker Compose: a imagem oficial wallabag/wallabag, MariaDB, Redis e a porta web publicada em 127.0.0.1 atrás de um proxy inverso em HTTPS.
  3. Antes do primeiro arranque, defina 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.
  4. O proxy inverso envia X-Forwarded-Proto: https: é assim que o wallabag sabe que os seus visitantes chegam por HTTPS.
  5. Faça cópia da base de dados, do volume das imagens e do seu compose.yaml, e atualize alterando a etiqueta da imagem e executando as migrações.

O que faz o wallabag

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

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.

Os recursos a prever

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:

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.

A instalação com o Docker Compose

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:

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 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:

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

Para verificar que a aplicação responde, consulte a rota utilizada pela verificação de estado da imagem:

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

Com SQLite ou PostgreSQL

Sem Docker

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:

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 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 primeira conta, os segredos e os registos de utilizadores

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.

Terminal, no seu computador
ssh -L 8080:127.0.0.1:8080 user@read.example.com
  1. Inicie sessão com wallabag e wallabag.
  2. Em «Config», separador «Password», escolha uma nova palavra-passe com pelo menos 8 caracteres.
  3. No separador «User information», substitua o endereço de e-mail pelo seu: é ele que recebe as ligações de reposição da palavra-passe.
  4. No mesmo separador, ative a autenticação de dois fatores. A documentação recomenda uma aplicação de códigos de utilização única, como o FreeOTP, em vez do código enviado por e-mail; o wallabag oferece também códigos de recuperação.
VariávelValor por omissãoO que faz
SYMFONY__ENV__SECRETUma cadeia pública, a mesma para todas as instânciasAcrescenta entropia às operações de segurança: a documentação quer que seja única para a sua instância
SYMFONY__ENV__DOMAIN_NAMEhttps://your-wallabag-instance.wallabag.orgO endereço completo da sua instância, sem barra final
SYMFONY__ENV__FOSUSER_REGISTRATIONfalse na imagem DockerAbre ou fecha o registo público
SYMFONY__ENV__FOSUSER_CONFIRMATIONtrueEnvia um e-mail de confirmação para cada registo
SYMFONY__ENV__LOCALEenA língua por omissão da instância, como pt
SYMFONY__ENV__SERVER_NAMEYour wallabag instanceO 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.

HTTPS: o proxy inverso

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.

Com o Caddy

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:

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 instalar o HTTPS:

Bloco 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

Verifique depois que SYMFONY__ENV__DOMAIN_NAME contém o endereço em https://, o mesmo que o do seu proxy.

As aplicações, as extensões e os feeds RSS

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.

FerramentaO que fazDo que precisa
Aplicação AndroidSincroniza as suas listas de artigos e mostra-as no telemóvelO 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 iOSMostra os seus artigos no iPhone e no iPadO 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 ChromeGuarda a página aberta, com as suas etiquetas, como favorita ou arquivadaO 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 marcadoresNada: arrasta-se a partir da página «Howto»

Importar os seus artigos do Pocket e de outros serviços

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çoO ficheiro a fornecer
Pocket, exportação CSVO ZIP de exportação do Pocket, depois de extraído: um ficheiro CSV com um nome como part_000000.csv
Pocket, exportação HTMLO ficheiro HTML da exportação antiga do Pocket, como ril_export.html
InstapaperO CSV da página de definições do Instapaper
OmnivoreOs ficheiros metadata_x_to_y.json da exportação extraída, um de cada vez
Pinboard, DeliciousA respetiva exportação JSON
ShaarliA sua exportação HTML
Firefox, ChromeA cópia de segurança JSON dos marcadores do Firefox, ou o ficheiro Bookmarks do Chrome
Readability, elCuratorA respetiva exportação
wallabag 1.x ou 2.xA 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.

As grandes importações em segundo plano

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. Em «Internal Settings», secção «Import», ative o Redis com o valor 1.
  2. Lance a importação a partir do menu «Import»: o wallabag coloca os artigos numa fila.
  3. Inicie o processo de trabalho do tipo de importação escolhido, por exemplo pocket_csv; esvazia a fila e depois continua à escuta até o parar.
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 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:

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

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.

As cópias de segurança

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:

ElementoOnde se encontraComo copiá-lo
As definiçõesO seu compose.yaml: a imagem gera a partir dele parameters.yml em cada arranqueUma cópia do ficheiro, guardada em segurança, porque contém os seus segredos
A base de dadosO volume wallabag-dbUma exportação com mariadb-dump
As imagensO volume wallabag-images, montado em web/assets/imagesUm arquivo 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

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.

O restauro

Numa instalação nova, arranque o conjunto com o mesmo compose.yaml e depois volte a carregar a base 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 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.

As atualizações

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:

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

Quem faz o quê num VPS gerido

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.

AssuntoAs nossas equipasVocê
O servidorAtualizações do sistema e de segurança, intervenções no servidor incluídasO momento que convém à sua atividade
A supervisãoServidor acompanhado 24 horas por dia, 7 dias por semana, com intervenção sem esperar pela sua chamadaA leitura dos registos da sua instância
wallabagAcompanhamento proativo: erros, lentidão, base de dados e espaço em disco identificados, correção recomendadaA 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 artigosO servidor que os suporta, vigiado e com cópias de segurançaOs utilizadores, os registos, os clientes da API e as importações
As cópias de segurançaTodas as noites, cifradas e guardadas fora da máquina; restauro incluídoAs exportações próprias do wallabag e o pedido de restauro, quando precisar
A migraçãoO seu servidor atual migrado, oferecidoO 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.

O wallabag, num servidor mantido por si

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.

Descobrir os VPS geridos

Perguntas frequentes

O wallabag é gratuito?

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.

Como instalar o wallabag com o Docker Compose?

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.

Quais são os acessos por omissão do wallabag?

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.

Como importar os meus artigos do Pocket para o wallabag?

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.

Que aplicações funcionam com o wallabag?

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.

Porque é que as ligações do wallabag ficam em http atrás de um proxy?

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.

Como fazer cópia de segurança do wallabag?

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

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.

Fontes e documentação oficial

Guias relacionados

Alojar FreshRSS num VPS gerido: os seus feeds RSS no seu servidorAlojar FreshRSS num VPS gerido é ler os seus feeds RSS, sozinho ou com a sua equipa, a partir de uma máquina sua, que as nossas equipas mantêm atualizada e supervisionam dia e noite. O FreshRSS é um software livre sob licença AGPL-3.0. Este guia segue a sua documentação oficial: a instalação com o Docker Compose, o HTTPS, a atualização dos feeds, as contas e o início de sessão, a API para as aplicações móveis, a base de dados, as cópias de segurança e as atualizações.Backups de um VPS: o que verificar antes de contratarUma oferta de VPS anuncia quase sempre «cópias de segurança incluídas». Por trás destas palavras pode haver uma cópia todas as noites, guardada fora da máquina e restaurada por especialistas, ou um instantâneo colocado no mesmo disco que o servidor. Este guia dá as perguntas que fazem a diferença, o que cada resposta quer dizer, e a forma de verificar que uma cópia de segurança se restaura.Diferença entre VPS gerido e não gerido: quem faz o quêA diferença entre um VPS gerido e um VPS não gerido resume-se a uma pergunta: quem trata do servidor depois de ele estar a funcionar. No entanto, «gerido» não tem definição oficial e, de um fornecedor de alojamento para outro, a palavra vai da simples instalação do sistema à exploração completa do servidor. Este guia mostra quem faz o quê, linha a linha, com o nível intermédio da assistência, e dá as perguntas que eliminam a ambiguidade antes de assinar.
Contacte-nos