Listmonk na VPS: newsletter própria com Docker
Aprenda a instalar o Listmonk no seu servidor com Docker Compose, trocar a senha do banco, criar o administrador, configurar o SMTP, ligar o HTTPS e atualizar.
Por Redação Eleven Host · @robson.direitodigital · 2 de novembro de 2026 · 8 min de leitura

Capa da Redação Eleven Host para o tutorial: Listmonk na VPS: newsletter própria com Docker Arte: Eleven Host
O Listmonk na VPS é um gerenciador de newsletter e de listas de e-mail que você hospeda por conta própria. Você instala com Docker Compose, e os envios saem por um servidor SMTP que você configura.
O que é o Listmonk e qual é a licença
A documentação define o Listmonk como um gerenciador de newsletter e de listas de e-mail, de mão única, hospedado por você e de alto desempenho.
O Listmonk guarda listas, inscritos e campanhas, mas não envia e-mail sozinho: o envio depende de um servidor SMTP que você configura.
Segundo a documentação, o Listmonk é licenciado sob a AGPLv3, a GNU Affero General Public License, versão 3. Se tiver dúvida sobre o que essa licença exige no seu caso, consulte um profissional.
Antes de começar
Se você está conhecendo servidores agora, leia primeiro o guia de iniciantes sobre servidor VPS. Para este tutorial, você precisa de:
- Docker com o plugin Compose instalado na VPS.
- Um banco PostgreSQL. A documentação pede PostgreSQL 12 ou superior, e o arquivo oficial do Docker Compose já traz o PostgreSQL pronto, na imagem
postgres:17-alpine. Você não precisa instalar o banco à parte. - Um servidor SMTP de um serviço de e-mail, para os envios. Veja a seção sobre SMTP mais abaixo.
- Um domínio ou subdomínio, como
newsletter.exemplo.com, apontado para o IP da VPS, se você quiser acessar com HTTPS.
A documentação do Listmonk não informa requisitos de memória, processador ou disco. Por isso, comece pequeno, acompanhe o consumo e ajuste conforme o tamanho das suas listas.
Está escolhendo uma VPS? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver os planos de VPS
Passo a passo: instalar com Docker Compose
Primeiro, baixe o arquivo oficial do Compose. O comando curl -LO só baixa o arquivo, sem executar nada:
curl -LO https://github.com/knadh/listmonk/raw/master/docker-compose.yml
Antes de subir, abra o arquivo e troque a senha padrão do banco. No começo dele há um bloco chamado x-db-credentials, que define o usuário, a senha e o nome do banco. Os três vêm como listmonk:
x-db-credentials: &db-credentials
POSTGRES_USER: &db-user listmonk
POSTGRES_PASSWORD: &db-password listmonk
POSTGRES_DB: &db-name listmonk
Troque ao menos o valor de POSTGRES_PASSWORD por uma senha forte e única, e guarde-a num lugar seguro. Fazer isso antes da primeira subida evita ficar com a senha padrão no banco. O restante do arquivo reaproveita esses valores, então você muda em um lugar só.
No serviço app, o arquivo traz o campo hostname com o valor listmonk.example.com, e o próprio comentário recomenda um nome de domínio completo. Troque pelo seu.
Agora suba os serviços em segundo plano:
docker compose up -d
Você não precisa rodar a instalação do banco à parte. O comando do serviço app já executa --install --idempotent, que cria as tabelas só na primeira subida, com o banco vazio. Em seguida roda o --upgrade, que aplica as migrações do banco quando uma imagem nova é baixada.
O arquivo publica duas portas: a 9000, do Listmonk, e a 5432, do PostgreSQL. O banco já está ligado apenas ao endereço 127.0.0.1, ou seja, só o próprio servidor acessa. Já a porta 9000 aparece como "9000:9000", que a deixa aberta nas interfaces do servidor. Veja como ajustar isso na seção de HTTPS.
Para conferir as portas que ficaram abertas, o guia Portas abertas no Linux: como ver com ss e lsof na VPS mostra o caminho.
Primeiro acesso e conta de administrador
Com os contêineres no ar, abra a porta 9000 do servidor no navegador, por exemplo http://203.0.113.10:9000 (um IP de exemplo; use o da sua VPS). Se você não definiu o administrador antes, a tela inicial pede para criar o Super Admin. Segundo a documentação, é por essa tela que você entra pela primeira vez.
Na prática, isso significa que quem abrir o endereço primeiro cria o administrador. Por isso, faça esse cadastro logo depois de subir, antes de divulgar o endereço.
A documentação mostra outra forma: criar o Super Admin já na subida, com duas variáveis. Isso vale só para a primeira vez:
LISTMONK_ADMIN_USER=myuser LISTMONK_ADMIN_PASSWORD=xxxxx docker compose up -d
Troque myuser e xxxxx pelos seus valores.
Configurar o SMTP para os envios
O Listmonk não entrega e-mail por conta própria. Quem envia é o servidor SMTP que você informar, e o Listmonk entrega a ele as mensagens das campanhas. Use um serviço de SMTP e consulte a documentação dele para obter servidor, porta, usuário e senha.
Segundo a documentação do Listmonk, fora o banco de dados e algumas poucas variáveis de baixo nível, as configurações ficam no painel do administrador, em Settings, e o SMTP está entre elas. Abra essa página, cadastre os dados do seu serviço e faça um envio de teste para você mesmo antes de disparar uma campanha.
A documentação traz três avisos úteis sobre o envio:
- Alguns provedores de servidor bloqueiam as portas de saída 25 e 465.
- Alguns provedores, como o Google Workspace, exigem que o HELO seja um nome de domínio completo e válido.
- Se um envio falhar, o Listmonk tenta de novo em outras conexões do conjunto. Se a falha persistir, ele registra o erro e descarta a mensagem.
O Listmonk não garante que a mensagem chegue à caixa de entrada. Isso depende do serviço de SMTP que você usa.
HTTPS com um proxy reverso
A documentação não traz um passo a passo de HTTPS para o Listmonk; ela aponta tutoriais da comunidade para quem usa Nginx e certbot. Uma forma é colocar um proxy reverso na frente da porta 9000, que cuida do certificado e encaminha o acesso para o Listmonk. Esse caminho é uma adaptação nossa, não uma instrução oficial.
Para que o Listmonk só receba acesso pelo proxy, troque a linha da porta no arquivo do Compose, no serviço app:
- "127.0.0.1:9000:9000"
Assim, a porta 9000 fica visível só para o próprio servidor, e o proxy é o único caminho de fora. Depois, rode docker compose up -d de novo.
O guia Nginx Proxy Manager: vários sites numa VPS só mostra um painel para isso. Se preferir um servidor web com certificado automático, veja o Caddy na VPS.
A documentação traz ainda uma tabela de rotas para quem usa um proxy com autenticação. As rotas privadas são /admin/*, /api/* e /webhooks/bounce. As rotas públicas incluem /subscription/*, /link/*, /campaign/*, /public/* e /uploads/*. Se for proteger o painel, proteja as privadas e deixe as públicas abertas.
Backup e atualização do Listmonk
A documentação de atualização avisa que você deve fazer um backup do banco PostgreSQL antes de atualizar o Listmonk. Ela não traz um comando de backup, então siga o método de cópia do PostgreSQL que você já utiliza e guarde a cópia fora da VPS. Se você enviar imagens pelo painel, o arquivo do Compose guarda os envios na pasta ./uploads; para usá-la, a documentação manda indicar o caminho /listmonk/uploads em Admin, Settings, Media.
Na página de releases do GitHub, a última versão estável listada é a v6.2.0, de 26 de junho. A v7.0.0-beta.1, de 20 de outubro, aparece com a etiqueta de última versão, mas a própria página diz que é uma versão beta. Por isso, recomendamos usar a estável em produção. Para experimentar a beta, a documentação manda trocar a imagem para listmonk/listmonk:beta.
Com o backup feito, atualize com estes comandos da documentação, na pasta do arquivo do Compose:
docker compose down app
docker compose pull
docker compose up app -d
Como o --upgrade roda sozinho na subida, o banco é migrado sem passo extra. Se quiser controlar a versão, troque a etiqueta latest da imagem por uma versão fixa, como v6.2.0, antes de rodar os comandos.
Checklist depois de instalar
- Troquei a senha padrão
listmonkdo PostgreSQL antes da primeira subida. - Criei o Super Admin logo depois de subir.
- Configurei o SMTP em Settings e enviei um teste para mim.
- Publiquei a porta como
127.0.0.1:9000:9000e coloquei um proxy com HTTPS na frente. - Fiz o backup do banco PostgreSQL e guardei fora da VPS.
- Conferi se estou na versão estável, e não na beta.
Um domínio para a sua newsletter
Como os inscritos acessam páginas públicas do Listmonk, como as rotas /subscription/* e /link/*, o Listmonk precisa de um endereço acessível pela internet. Se ainda não tem um domínio, você pode registrar um na Eleven Host.
Ainda não tem um domínio para a sua newsletter? Registre o seu na Eleven Host. Registrar domínio
Perguntas frequentes
O Listmonk envia e-mail sozinho?
Não. Ele gerencia listas e campanhas, mas os envios saem por um servidor SMTP que você configura no painel, em Settings.
Qual é a licença do Listmonk?
Segundo a documentação, AGPLv3. Em caso de dúvida sobre uso comercial, consulte um profissional.
Em qual porta o Listmonk abre?
Na 9000. Para acesso externo com HTTPS, coloque um proxy reverso na frente.
Preciso instalar o PostgreSQL à parte?
Com o Compose oficial, não. O arquivo já sobe um PostgreSQL junto com o Listmonk e roda a instalação do banco na primeira subida.
Posso usar a versão 7?
Ela está em beta segundo a página de releases. Para uma instalação que você precisa manter estável, use a v6.2.0 e acompanhe quando a v7 sair da fase beta.