Base de Conhecimento

Listmonk na VPS: newsletter própria com Docker

  • listmonk na vps, listmonk, newsletter, docker, vps
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Listmonk na VPS: newsletter própria com Docker

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 listmonk do 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:9000 e 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.

Esta resposta lhe foi útil?

Artigos Relacionados