Stalwart: servidor de e-mail completo numa VPS
Veja o que o binário Rust do Stalwart substitui em Postfix e Dovecot, o que não resolve e quando o mailcow continua sendo a melhor escolha.
O que o Stalwart reúne num único binário
O Stalwart é um servidor de email que pode ser executado num único VPS como um binário Rust. O mesmo processo responde a SMTP, IMAP, POP3, JMAP, CalDAV, CardDAV e WebDAV, além de incluir o seu próprio filtro de spam, armazenamento de mensagens e cliente ACME. Uma stack convencional faz o mesmo trabalho com Postfix, Dovecot, Rspamd, uma base de dados para as contas e uma ferramenta de certificados separada. O Stalwart substitui tudo isso por uma única unidade de serviço e um único ficheiro de configuração em /etc/stalwart/config.json.
Todos os valores, nomes de definições e comandos abaixo foram retirados da documentação, das páginas de versões e do script de instalação do próprio Stalwart. Consultámos essas fontes pela primeira vez em 28 August 2026, com base na versão v0.16.19 (publicada em 24 August 2026), e voltámos a verificá-las em 12 October 2026, quando a versão mais recente era a v0.16.26. Voltámos a verificá-las em 27 October 2026, no dia seguinte à publicação do Stalwart v1.0.0 (26 October 2026). Verificámos novamente as fontes em 29 October 2026, quando a versão mais recente era a v1.0.1, publicada em 28 October 2026. Voltámos a verificar as fontes em 11 November 2026, quando a versão mais recente era a v1.1.0, publicada em 9 November 2026. Estes são comandos para executar no seu próprio servidor. Cada comando é seguido pela verificação que indica se foi executado com sucesso.
O Stalwart é distribuído sob duas licenças: GNU Affero General Public License v3.0 (AGPL-3.0) e Stalwart Enterprise License v2. Algumas funcionalidades estão disponíveis apenas na edição Enterprise. A lista documentada de endpoints HTTP assinala /scim/v2/* dessa forma. Leia os termos das licenças antes de planear uma implementação com base numa funcionalidade que ainda não testou.
Um único binário reduz efetivamente o número de componentes. Mas não reduz os dois fatores que determinam se as suas mensagens chegam ao destino.
A porta 25 e a reputação do DNS não dependem do software que utiliza
A porta TCP 25 de saída é o primeiro ponto de controlo. Muitos fornecedores de VPS bloqueiam-na por predefinição em contas novas, e uma porta 25 bloqueada impede o servidor de entregar correio diretamente ao servidor de correio de qualquer outro destinatário. Teste-a antes de instalar qualquer componente.
sudo apt update && sudo apt install -y netcat-openbsd
nc -vz -w 5 alt1.aspmx.l.google.com 25Um resultado normal apresenta Connection to alt1.aspmx.l.google.com ... 25 port [tcp/smtp] succeeded! em cerca de um segundo. Um bloqueio manifesta-se de uma de duas formas. Se os pacotes forem descartados a montante, nada envia um reset de volta, pelo que o nc fica bloqueado durante os cinco segundos completos e depois apresenta nc: connect to alt1.aspmx.l.google.com port 25 (tcp) failed: Connection timed out. Se a firewall os rejeitar, envia um erro ICMP de volta (o reject do netfilter envia port unreachable, exceto quando é configurado para enviar outra mensagem, como administratively prohibited), pelo que a falha é apresentada imediatamente, normalmente como Connection refused ou No route to host. Em qualquer dos casos, abra um ticket com o fornecedor.
Se o fornecedor não a desbloquear, a única alternativa é utilizar um relay. O Stalwart pode entregar todo o correio de saída a um smarthost através de uma rota Relay. A porta predefinida é 25, mas pode ser usado qualquer valor entre 1 e 65535. A rota inclui um seletor implicitTls e os campos authUsername e authSecret para um relay autenticado na porta 465 ou 587. O seu correio sai com a reputação do relay, não com a sua.
O segundo ponto de controlo é a forma como as redes recetoras avaliam o seu endereço IP e o seu domínio. Isso inclui o DNS inverso do IP, SPF, DKIM, DMARC e o histórico de envio do bloco de endereços onde ficou. A página de configuração de DNS do Stalwart, tal como a consultámos em 28 August 2026, era clara sobre onde esse trabalho é feito: os registos de DNS inverso "são normalmente configurados pelo fornecedor de alojamento, não pelo próprio Stalwart". O Stalwart pode publicar e manter os outros registos DNS através da API de um fornecedor de DNS suportado, mas o DNS inverso e a reputação do IP continuam a depender do seu fornecedor.
Por isso, esta página não volta a explicar esses registos. Temos uma página que o faz: Configuração única de SPF, DKIM e DMARC para tudo o que envia correio. Se ainda não decidiu se deve alojar o seu próprio correio, comece por a nossa análise honesta sobre se o correio eletrónico autoalojado ainda compensa. Escolher o Stalwart não altera nenhum desses fatores.
O que um VPS pequeno precisa para executar um servidor de e-mail Stalwart
A página de requisitos de sistema do Stalwart, consultada em 27 October 2026, já não apresenta um valor por utilizador. Indica que um servidor ocioso “fica bem abaixo” dos limites de memória e que o uso de CPU depende do volume de e-mail e dos inícios de sessão, não do número de contas. O hashing de palavras-passe é deliberadamente lento, por isso um servidor com muitos inícios de sessão precisa de mais núcleos. O único exemplo de dimensionamento da página é um host com 2 GiB de RAM, no qual os limites predefinidos totalizam cerca de 2.4 GiB. Esse total inclui duas reservas de 512 MiB para contas muito grandes, que permanecem vazias se não tiver nenhuma. A FAQ acrescenta que não foi publicado nenhum valor medido de utilizadores por node.
As ligações têm um limite por listener, não por servidor. maxConnections tem o valor predefinido de 8,192 em cada listener que não tenha uma configuração própria, por isso o limite de file descriptors do processo tem de abranger várias vezes esse valor. O script de instalação aumenta-o para 65536. Um serviço iniciado de outra forma recebe frequentemente o valor 1024, que a página considera demasiado baixo para produção.
A página não define um tamanho mínimo de disco. O benchmark mediu cerca de 0.95 GB de disco por GB de e-mail no RocksDB e observou que os anexos já comprimidos, como imagens e PDFs, podem precisar de mais espaço. Dimensione o disco para o e-mail que espera manter, com espaço adicional para a compactação do store.
Três caminhos de saída têm de funcionar, caso contrário o servidor parece avariado por motivos que não estão relacionados com o e-mail. No arranque, descarrega o bundle da interface web de https://github.com/stalwartlabs/webui/releases/download/v2/webui.zip. Acede a https://acme-v02.api.letsencrypt.org/directory para obter certificados Let's Encrypt. Precisa de DNS nas portas UDP e TCP 53 para pesquisas de registos MX e de autenticação, a menos que o resolver esteja configurado para DNS over HTTPS ou TLS. As regras do filtro de spam e as listas de IP para ASN e país também vêm do GitHub. Um firewall de egress restritivo que bloqueie o primeiro caminho deixa-o com um servidor de e-mail em execução, mas as páginas /admin e /account devolvem 404.
Instale uma versão fixada, não a versão "latest"
O instalador oficial é um script de shell. Leia-o antes de o executar.
curl --proto '=https' --tlsv1.2 -sSf https://get.stalw.art/install.sh -o install.sh
less install.sh
sudo sh install.shA leitura desse script em 27 October 2026 mostra exatamente o que ele faz. O script cria uma conta de serviço stalwart e os diretórios de que precisa. Em seguida, descarrega de https://github.com/stalwartlabs/stalwart/releases/latest/download. O binário é instalado em /usr/local/bin/stalwart com o modo 0755. A configuração vai para /etc/stalwart/config.json, os dados para /var/lib/stalwart e os logs para /var/log/stalwart; os três diretórios ficam com o modo 0750 e pertencem a stalwart. É criado um ficheiro de ambiente em /etc/stalwart/stalwart.env, com o modo 0640 e pertencente a root:stalwart. O script aceita um prefixo de instalação opcional e uma flag --fdb para a compilação do FoundationDB. Não aceita um argumento de versão.
Este último ponto é importante. O script descarrega sempre a versão mais recente. Dois servidores instalados com uma semana de diferença executam a mesma versão se não for publicada nenhuma versão nesse intervalo. Em 26 October 2026, a versão mais recente passou a ser v1.0.0, que alterou o esquema da base de dados. As notas da versão dizem que as implementações existentes da versão v0.16.x "não podem ser atualizadas no local", e o anúncio da v1.0 diz que um servidor v1.0 não abre um armazenamento criado por uma versão anterior. Dentro da linha 1.x, a página de atualização do Stalwart diz que voltar a executar o script de instalação "substitui o binário, mantém config.json e o ficheiro de ambiente e reinicia o serviço", e a FAQ diz para fazer uma cópia de segurança dos armazenamentos de dados e de config.json antes de cada atualização minor ou major. Só a linha 0.16 teve sete versões patch entre 24 August e 11 October 2026, várias delas com correções de segurança. Por isso, fixe a versão mais recente e altere essa fixação de forma intencional.
Ao atualizar uma instalação 1.x existente para v1.1.0, reinicie uma vez com STALWART_UPDATE_ROLE_PERMISSIONS=true para adicionar as permissões introduzidas desde v1.0.0 e, em seguida, remova a variável. A atualização a partir de v1.0.0 ou v1.0.1 também desativa a encriptação em repouso por conta. Selecione novamente a chave pública de cada conta para a reativar; caso contrário, as mensagens novas permanecerão sem encriptação. As chaves registadas e as mensagens já encriptadas não são afetadas.
STALWART_TAG=v1.1.0
curl -fsSLO "https://github.com/stalwartlabs/stalwart/releases/download/${STALWART_TAG}/stalwart-x86_64-unknown-linux-gnu.tar.gz"
tar zxf stalwart-x86_64-unknown-linux-gnu.tar.gz
sudo systemctl stop stalwart
sudo install -m 0755 -o root -g root stalwart /usr/local/bin/stalwart
sudo systemctl start stalwart
systemctl is-active stalwartsystemctl is-active stalwart deve mostrar active. Se mostrar qualquer outra coisa, leia journalctl -u stalwart -n 50. O artefacto da versão Linux é fornecido com um pacote .sigstore.json correspondente, pelo que a assinatura do download pode ser verificada antes da instalação.
Se o servidor já executar uma versão 0.16, não substitua o binário por um binário 1.x. Atualize primeiro para v0.16.27 e siga depois o procedimento de migração descrito na secção abaixo sobre a importação de correio existente.
A unidade criada pelo script é executada como User=stalwart, define AmbientCapabilities=CAP_NET_BIND_SERVICE e define LimitNOFILE=65536. Essa capability permite que uma conta sem privilégios associe portas 25, 443, 465 e 993. Se criar posteriormente a sua própria unidade e omitir essa linha, os listeners nas portas privilegiadas não conseguem fazer bind; o Stalwart ignora esses listeners, inicia os restantes e regista um evento registry.build-error para cada listener que falhar. Copie também o limite de ficheiros, pelo motivo indicado na secção de requisitos.
Onde é apresentada a primeira palavra-passe de administrador
O Stalwart inicia no modo de bootstrap e escreve no log do serviço uma conta temporária chamada admin, com uma palavra-passe aleatória de 16 caracteres. Apresenta uma nova palavra-passe em cada arranque no modo de bootstrap, por isso apenas o bloco mais recente é válido.
sudo journalctl -u stalwart -n 200 | grep -A8 'bootstrap mode'O assistente de configuração escuta em HTTP simples na porta 8080. A página do Stalwart para Docker indica que não existe proteção contra tentativas de adivinhar a palavra-passe, por isso não exponha essa porta. Numa instalação por script, bloqueie a porta TCP de entrada 8080 na firewall do anfitrião antes da configuração. Um túnel SSH, por si só, não fecha o acesso público. Crie o túnel a partir do portátil através de SSH:
ssh -N -L 8080:127.0.0.1:8080 you@your-vpsDepois, abra http://127.0.0.1:8080/admin e inicie sessão como admin usando a palavra-passe do log. O assistente pede o nome de anfitrião do servidor, o domínio de correio predefinido, o TLS, o armazenamento, o diretório de contas, o registo e o tratamento do DNS. Com o diretório interno, o último ecrã apresenta o novo administrador, admin@<domain>, e uma palavra-passe aleatória que o servidor não apresenta nem regista novamente. Guarde-a nesse momento. Reinicie o serviço quando terminar e, a partir daí, use https://<your-host>/admin.
Se a palavra-passe já tiver saído do log, defina uma palavra-passe fixa. /etc/stalwart/stalwart.env inclui entradas comentadas para este caso, incluindo STALWART_RECOVERY_ADMIN=admin:changeme, STALWART_RECOVERY_MODE=true e STALWART_RECOVERY_MODE_PORT (8080 por predefinição). Retire os comentários, reinicie, inicie sessão e volte a comentar as entradas. A página do Stalwart sobre a proteção do servidor avisa que uma variável esquecida é "uma credencial permanente com acesso total", por isso remova-a depois de uma conta de administrador permanente iniciar sessão. A mesma página recomenda usar contas de administrador apenas para administração, e não como caixas de correio em clientes IMAP, JMAP ou DAV.
No modo de bootstrap, o Stalwart não inicia serviços de correio e abre apenas um listener HTTP simples, na porta 8080 por predefinição. Depois da configuração e de um reinício, os listeners normais iniciam nas portas 25, 465, 993, 995, 4190, 443 e 8080. A porta 25 tem de permanecer aberta para receber correio, e a porta 443 é necessária para a maioria dos clientes e para o desafio ACME predefinido. A documentação recomenda remover a porta 995 quando nenhum cliente usa POP3, a porta 4190 quando ninguém gere filtros Sieve a partir de um cliente ManageSieve e a porta 8080 depois de a configuração terminar e o HTTPS na porta 443 funcionar. As portas 587, 143 e 110 não têm nenhum listener, a menos que crie um.
Executar no Docker com uma tag fixada
A imagem documentada é stalwartlabs/stalwart, também publicada como ghcr.io/stalwartlabs/stalwart. Em 29 October 2026, o Docker Hub disponibilizava v1.0.1, v1.0 e v1, cada uma com uma variante -alpine. A página do Stalwart para Docker recomenda a tag da versão principal v1, que acompanha a versão 1.x mais recente, e desaconselha latest, porque uma versão principal futura pode exigir um procedimento de atualização diferente. Fixe a versão de patch pelo mesmo motivo indicado para o binário acima.
services:
stalwart:
image: stalwartlabs/stalwart:v1.1.0
container_name: stalwart
init: true
restart: unless-stopped
ports:
- "25:25"
- "465:465"
- "993:993"
- "443:443"
- "127.0.0.1:8080:8080"
volumes:
- stalwart-etc:/etc/stalwart
- stalwart-data:/var/lib/stalwart
volumes:
stalwart-etc:
stalwart-data:Esse ficheiro contém o comando documentado docker run escrito em Compose, com as portas POP3S e ManageSieve omitidas e a porta de configuração ligada apenas a localhost, tal como no comando documentado. Inicie o serviço e leia a mesma linha de bootstrap:
docker compose up -d
docker compose logs stalwart 2>&1 | grep -A8 'bootstrap mode'A página do Docker também documenta STALWART_RECOVERY_ADMIN=admin:<password> como forma de definir uma palavra-passe conhecida no arranque. No Compose, isto corresponde à chave environment:, se preferir essa opção a consultar os logs. A página salienta que as variáveis de ambiente ficam fixadas quando um contentor é criado, portanto um simples reinício não aplica uma alteração. docker compose up -d recria o contentor quando o ambiente muda. Remova a variável depois da configuração.
A lista completa de portas documentada e o motivo pelo qual este ficheiro é mais curto
A página do Stalwart para Docker publica as portas 25, 465, 993, 995, 4190 e 443 em todas as interfaces, e a porta 8080 apenas na interface de loopback (127.0.0.1:8080:8080). Não publica 587, 143 nem 110, que não têm nenhum listener, a menos que um administrador crie um. A página sobre como proteger o servidor recomenda remover o listener POP3S na porta 995 quando nenhum cliente usa POP3, o listener ManageSieve na porta 4190 quando nenhum utilizador gere filtros Sieve a partir de um cliente, e o listener 8080 depois de a configuração estar concluída e de o HTTPS na porta 443 funcionar. Reative apenas as portas de que os seus clientes realmente precisam. Se um telefone exigir submissão com STARTTLS, crie um listener na porta 587 e publique-o. Se os seus utilizadores escreverem regras Sieve a partir de um cliente de desktop, publique a porta 4190.
Se o Compose for uma novidade para si, o nosso guia de Docker Compose para um VPS explica a estrutura dos ficheiros e o modelo de volumes nomeados utilizado aqui. Há um aviso especialmente importante para servidores de correio: o Docker publica portas através das suas próprias regras de firewall, e essas regras são avaliadas antes das regras do ufw. Por isso, ufw deny 8080 não fecha uma porta publicada pelo Compose. Com o Docker Engine 28.0.0 ou posterior e a configuração de rede bridge predefinida, associar 127.0.0.1 no mapeamento de portas restringe o acesso ao host Docker. É por isso que o ficheiro acima faz essa associação e que o túnel SSH continua a aplicar-se. O Docker avisa que versões anteriores à 28.0.0 permitem que hosts no mesmo segmento de rede L2 acedam a portas publicadas em localhost. Atualize o Docker antes de depender desta proteção.
TLS sem certbot: o que muda e qual é o custo
O Stalwart implementa diretamente o ACME (automatic certificate management environment), por isso não há certbot nem hook de renovação. A documentação lista quatro métodos de validação. O HTTP-01 responde a um pedido de validação na porta 80. O TLS-ALPN-01, que é o método predefinido, apresenta um certificado específico na porta 443 usando o protocolo ALPN do ACME. O DNS-01 publica registos TXT temporários e é um dos dois métodos que podem emitir certificados wildcard. O DNS-PERSIST-01 usa registos TXT de autorização de longa duração, em vez de criar um novo registo a cada renovação.
O custo é que o Stalwart precisa de controlar o handshake TLS. O TLS-ALPN-01 funciona ao concluir o handshake diretamente, por isso não funciona atrás de um reverse proxy que termina o TLS. Se o nginx ou o Caddy já ocupar a porta 443 nesse servidor, há três opções. O guia do Stalwart para nginx configura o nginx como passthrough TCP, com listen 443; proxy_pass 127.0.0.1:10443; proxy_protocol on;, para que a ligação TLS chegue ao Stalwart sem alterações. Isso entrega ao Stalwart todas as ligações na porta 443, por isso é adequado para um servidor onde o nginx não serve mais nada nessa porta. Caso contrário, altere o Stalwart para DNS-01 ou HTTP-01, ou atribua-lhe o seu próprio endereço IP.
DANE e MTA-STS e os padrões que você deve conhecer
Ambos são configurados por estratégia TLS no objeto MtaTlsStrategy, em Settings, MTA, Outbound, TLS Strategies, na interface web. O campo dane assume optional por padrão. Ele tenta validar DANE quando o destinatário publica registos TLSA e recorre ao STARTTLS normal quando não publica. Defina-o como require para que a entrega só prossiga quando existir um registo TLSA verificável. O campo mtaSts funciona da mesma forma e assume optional por padrão. Os timeouts relacionados são tlsTimeout, com o padrão de 3 minutos, e mtaStsTimeout, com o padrão de 5 minutos.
No lado de entrada, o Stalwart pode publicar a sua própria política MTA-STS em https://mta-sts.<domain>/.well-known/mta-sts.txt, que requer a porta 443 aberta. O singleton MtaSts tem mode, com o padrão testing, maxAge, com o padrão de 7 dias, e mxHosts, que substitui os hosts MX permitidos e, quando está vazio, obtém-nos das definições do sistema. Deve fornecer dois registos DNS: um CNAME mta-sts que aponta para o host de correio e um registo TXT _mta-sts que contém o identificador da política.
dig +short TXT _mta-sts.example.org
curl -s https://mta-sts.example.org/.well-known/mta-sts.txtA consulta TXT deve devolver uma string v=STSv1; id=..., e o curl deve devolver o conteúdo da política. Se o curl não devolver nada, a porta 443 está fechada ou o certificado de mta-sts.example.org nunca foi emitido.
Mantenha mode como testing até ambas as verificações serem aprovadas. Uma política no modo enforce com um certificado inválido impede outros servidores de entregar mensagens ao seu servidor. Os utilizadores irão informá-lo do problema antes de este aparecer num log. O DANE tem uma armadilha semelhante: requer zonas assinadas com DNSSEC tanto para o domínio de correio como para os hosts MX. Além disso, os registos TLSA publicados manualmente devem permanecer sincronizados com o certificado ou a chave que fixam. O Stalwart atualiza os registos TLSA depois da renovação quando a gestão automática de DNS está ativada e tlsa está incluído no publishRecords do domínio; por padrão, está excluído. Para registos publicados manualmente, reuseKey evita alterar o pin de chave pública a cada renovação. Em alternativa, pode fixar a CA emissora.
A criptografia em repouso não é uma criptografia de ponta a ponta
Esta é a funcionalidade mais frequentemente interpretada de forma incorreta. Por isso, segue exatamente o que a documentação diz. A criptografia em repouso é ativada por conta. O utilizador exporta a sua chave pública a partir do cliente de email, cola a chave OpenPGP em formato ASCII-armored ou o certificado S/MIME codificado em PEM no gestor de contas em /account, em Account, Public Keys, e depois seleciona essa chave na configuração de criptografia da conta. A partir desse momento, o servidor criptografa cada mensagem recebida com essa chave antes de a armazenar, como uma mensagem OpenPGP/MIME ou S/MIME. A opção atRestEnable, válida para todo o servidor, no singleton Encryption, vem ativada por padrão. Quando está desativada, nada é criptografado, independentemente das configurações da conta. A configuração encryptOnAppend, por conta, vem desativada por padrão. Ela estende a criptografia às mensagens adicionadas por JMAP e IMAP. Enquanto estiver desativada, essas mensagens nunca são criptografadas. Na v1.0.1, as mensagens JMAP que contêm $draft e as cópias enviadas criadas pelo envio via JMAP permanecem sem criptografia, mesmo quando a criptografia de anexação está ativada. Desde a v1.0.2, o algoritmo é escolhido a partir da chave do utilizador, e a escolha de cifra por conta foi removida.
Assim, ela protege contra uma imagem de disco roubada, um backup roubado e a leitura do armazenamento por um operador depois da entrega. A chave privada nunca chega ao servidor. Sem ela, os corpos armazenados não podem ser lidos, e o administrador também não pode descriptografá-los.
Ela não protege a mensagem durante o trânsito. A mensagem atravessa a internet usando o TLS que os dois servidores negociaram, chega em texto simples, e o Stalwart a criptografa nesse momento. O remetente, o provedor do remetente e qualquer salto que tenha removido o TLS já tiveram acesso ao texto simples.
Vale a pena declarar claramente mais quatro limitações. Em 11 de novembro de 2026, a documentação declara todas elas. As pastas Sent e Drafts são gravadas pelo cliente, usando uma operação de anexação, e a configuração encryptOnAppend por conta vem desativada por padrão. Os rascunhos JMAP e as cópias enviadas criadas pelo envio via JMAP continuam sem criptografia quando essa opção está ativada. A criptografia cobre apenas o corpo e os anexos. Cabeçalhos como From, To, Subject e Date permanecem em texto simples, e o envelope e os logs de entrega não são afetados. A criptografia “não é retroativa em nenhuma direção”. Portanto, as mensagens armazenadas antes do registo de uma chave continuam legíveis, e desativar a criptografia não descriptografa o que foi armazenado enquanto ela estava ativada. Uma pesquisa no corpo ou nos anexos de uma mensagem criptografada não encontra resultados, por JMAP nem por IMAP. As pesquisas por remetente, destinatário ou assunto continuam a funcionar.
A aprendizagem de spam pode deixar uma cópia separada em texto simples. A configuração allowSpamTraining por conta, desativada por padrão, permite criar amostras antes da criptografia. A aprendizagem automática configurada para todo o servidor também pode manter amostras, independentemente das configurações de criptografia da conta.
Se um utilizador perder a sua chave privada, o email será perdido. Não existe um mecanismo de recuperação, por decisão de projeto.
Desde a v1.0.3, o Stalwart também oferece criptografia separada de blobs, com chaves simétricas mantidas pelo servidor. Isso protege o backend de armazenamento de blobs, mas o servidor pode descriptografá-los. Portanto, não oferece a mesma proteção contra a leitura das mensagens armazenadas por um administrador.
WKD é uma tarefa de servidor web, não uma tarefa de servidor de correio
WKD (Web Key Directory) é a outra parte do OpenPGP e resolve um problema diferente. Publica a sua chave pública num URL HTTPS fixo sob o seu domínio, para que o cliente de correio do remetente a possa encontrar e cifrar a mensagem antes de ela sair da máquina do remetente. Isto é cifragem de ponta a ponta. A cifragem em repouso do Stalwart aplica-se à cópia armazenada no disco. Configurar uma não fornece a outra.
O Stalwart não serve WKD. Os endpoints HTTP documentados, consultados em 27 October 2026, listam caminhos conhecidos para jmap, caldav, carddav, oauth-authorization-server, openid-configuration, oauth-protected-resource, user-agent-configuration.json, autoconfig, mail-v1.xml, mta-sts.txt e acme-challenge. Não existe o caminho openpgpkey. Sirva-o a partir de um servidor web estático comum.
A especificação define dois layouts. O método avançado usa https://openpgpkey.example.org/.well-known/openpgpkey/example.org/hu/iy9q119eutrkn8s1mk4r39qejnbu3n5q?l=Joe.Doe. O método direto usa https://example.org/.well-known/openpgpkey/hu/iy9q119eutrkn8s1mk4r39qejnbu3n5q?l=Joe.Doe. Essa cadeia de 32 caracteres é o SHA-1 da parte local convertida para minúsculas e codificada em z-base-32. Por isso, nunca crie estes nomes de ficheiro manualmente. O GnuPG cria-os por si.
gpg --export --armor you@example.org > you.asc
gpg-wks-client --print-wkd-url you@example.org
gpg-wks-client --install-key you.asc you@example.org--print-wkd-url imprime o URL que um cliente vai consultar, usando o formato com subdomínio. --install-key grava a chave numa árvore de diretórios local que reproduz o layout WKD, sob um diretório de nível superior chamado openpgpkey por predefinição e alterado com -C dir. Copie essa árvore para a raiz web, adicione o ficheiro policy necessário junto do diretório hu (um ficheiro vazio é válido) e consulte o seu próprio URL com curl para confirmar que devolve bytes da chave, e não um 404.
Armazenamento numa única VPS
O Stalwart divide o armazenamento em quatro funções: um data store para registos estruturados, como contas, estrutura das caixas de correio e definições; um blob store para os bytes brutos das mensagens e anexos; um search store para o índice de texto completo; e um in-memory store para dados temporários, como contadores de limites de taxa, entradas de greylisting, locks e tokens. Cada função pode apontar para um backend diferente. A lista de opções suportadas inclui RocksDB, FoundationDB, PostgreSQL, MySQL e MariaDB, SQLite, o sistema de ficheiros, armazenamento de objetos compatível com S3, Azure Blob Storage, Redis, ElasticSearch e Meilisearch.
Numa VPS, a resposta é simples. A documentação chama ao RocksDB "the default and recommended data store for single-node installations", e o guia de armazenamento diz que usar RocksDB com todos os outros stores deixados na configuração predefinida é a configuração mais simples para um servidor único. O Redis "cannot serve as the data store, the blob store or the search store". Serve como in-memory store, coordenador de cluster ou camada de cache. Por isso, não é necessário um contentor Redis separado para começar. Mais tarde, pode mover o blob store para S3 se as caixas de correio excederem o espaço disponível em disco.
As cópias de segurança dependem do backend. A FAQ, consultada em 27 October 2026, diz que o servidor não cria cópias de segurança por si próprio, que copiar os ficheiros de um data store em execução não é uma cópia de segurança e que a exportação integrada é um dump offline de um servidor parado, destinado a mover dados entre backends. Faça a cópia de segurança de cada store com as ferramentas próprias do respetivo backend. Com RocksDB num servidor único, o guia de armazenamento indica que todos os dados ficam num único diretório, que é /var/lib/stalwart numa instalação por script. Copie-o com o serviço parado ou a partir de um snapshot do sistema de ficheiros ou do volume, e inclua uma cópia de config.json e do ficheiro de ambiente. Uma cópia ao nível dos ficheiros de um key-value store em execução pode capturar o store durante uma escrita. Só descobrirá o problema quando tentar restaurá-lo.
O filtro antispam que substitui o Rspamd
A filtragem é executada no mesmo processo, por isso não existe um segundo daemon que tenha de permanecer ativo. O classificador é configurado no singleton SpamClassifier, em Settings, Spam Filter, Classifier. Usa o algoritmo FTRL-Proximal com feature hashing. FtrlFh é o modelo predefinido. FtrlCcfh ativa o cuckoo feature hashing e destina-se a servidores onde as colisões de hash limitam a precisão do classificador, com o custo de mais memória e processamento por mensagem. O classificador aprende com as mensagens que os utilizadores marcam como spam ou como correio legítimo. Um classificador novo precisa de pelo menos 100 amostras de spam e 100 amostras de ham antes do primeiro treino. O classificador antispam de IA separado, que é executado com modelos de IA, é uma funcionalidade Enterprise.
Ao redor do classificador existem listas de bloqueio DNS, greylisting, deteção de phishing, armadilhas de spam e Pyzor. Também é possível chamar o SpamAssassin através de milter se tiver regras das quais não quiser abdicar.
Quando o mailcow continua a ser a escolha certa
O Stalwart não tem webmail. Essa é a maior lacuna e não está perto de ser resolvida. A documentação do mailcow, consultada em 12 October 2026, lista dezasseis componentes, incluindo o SOGo, que fornece aos utilizadores uma caixa de entrada no browser e uma interface CalDAV e CardDAV desde o início. O artigo do roadmap do Stalwart, publicado em 20 June 2025, diz que um webmail dedicado está planeado, mas que "not currently our immediate priority". Será desenvolvido em Rust com Dioxus depois de ser atingida a versão 1.0, "most likely sometime in 2026". A versão 1.0 foi lançada em 26 October 2026, e nem as notas da versão nem o anúncio mencionam webmail. Em 27 October 2026, o blogue do projeto ainda não tinha nenhum artigo a anunciar essa funcionalidade. Por isso, com o Stalwart, terá de instalar o Roundcube por conta própria ou pedir a todos os utilizadores que configurem um cliente de email.
O Stalwart tem uma interface de administração web, por isso essa não é a lacuna esperada. A segunda lacuna é o facto de a linha estável ser muito recente. O Stalwart permaneceu em versões 0.x até à publicação da v1.0.0, em 26 October 2026. A FAQ diz agora que "Version 1.0 is a stable release", e o anúncio afirma que o schema é agora estável e que as versões futuras serão atualizadas in-place. Essa promessa tinha dezasseis dias na data desta verificação, e todos os servidores 0.16 têm de ser migrados, em vez de atualizados, para chegar a essa versão.
A terceira lacuna é aquela que ninguém inclui numa lista de funcionalidades. Postfix, Dovecot e Rspamd têm uma década de respostas documentadas. Às duas da manhã, com mensagens na fila e utilizadores à espera, uma pesquisa que devolve uma mensagem de erro correspondente vale mais do que uma arquitetura elegante. Se essa é a sua situação, o nosso guia de instalação do mailcow percorre toda a stack de ponta a ponta e a noite será mais curta.
Escolha o Stalwart quando quiser um binário, um ficheiro de configuração e JMAP, e estiver confortável em adotar uma solução recente. Escolha o mailcow quando quiser webmail agora e uma grande quantidade de respostas já existentes.
Mover o correio existente
O caminho genérico é de IMAP para IMAP com imapsync, que não depende do software usado em nenhuma das extremidades. Faça primeiro uma execução de teste.
imapsync --dry \
--host1 old.example.org --user1 you@example.org --passfile1 /root/.old.pw \
--host2 mail.example.org --user2 you@example.org --passfile2 /root/.new.pw--dry faz com que o imapsync "não execute nada de facto; apenas mostra o que seria feito", por isso leia esse resultado antes de remover a opção. Cada ficheiro de palavra-passe contém a palavra-passe na primeira linha. Assim, chmod 600 ambos e elimine-os depois.
O Stalwart também disponibiliza ferramentas mais recentes às quais a maioria dos guias de terceiros ainda não se adaptou. O blogue documenta o Vandelay, um importador e exportador JMAP (29 May 2026), e um proxy de migração para atualizações sem indisponibilidade (10 June 2026). Leia ambos antes de planear uma migração de grande dimensão, porque são mais recentes do que quase tudo o que encontrará escrito noutras fontes.
Se o servidor antigo for o próprio Stalwart 0.16, a documentação apresenta agora dois caminhos para a versão 1.0. A ferramenta stalwart-migrate funciona apenas a partir da versão v0.16.27 e copia toda a implementação para um novo armazenamento da versão 1.0, com a indisponibilidade limitada a uma execução final enquanto todos os nós 0.16 estiverem parados. É necessário espaço em disco para uma segunda cópia do armazenamento de dados. O caminho conta a conta usa o proxy de migração e move as contas uma de cada vez enquanto os dois servidores estão em execução, mas os clientes terão de descarregar novamente os dados das contas movidas. A documentação recomenda stalwart-migrate para implementações pequenas e médias que possam aceitar uma janela curta de manutenção.
Modos de falha e mensagens que verá
A interface de administração nunca carrega. A página de requisitos do Stalwart identifica este caso diretamente: o pacote da interface web é descarregado do GitHub durante o arranque e, até esse descarregamento ser concluído, /admin e /account devolvem 404. Verifique com curl -sI https://github.com/stalwartlabs/webui/releases/download/v2/webui.zip a partir do servidor; um redirecionamento indica que o acesso funciona, enquanto um timeout indica um problema no firewall de saída. A página de resolução de problemas acrescenta mais duas causas. Depois da configuração, o início de sessão funciona apenas através de HTTPS em /admin, e o HTTP simples falha com Unknown client id. Atrás de um reverse proxy, ou numa porta HTTPS diferente de 443, o servidor tem de ser configurado com o URL usado pelos clientes.
Não existe uma password de bootstrap no log. Ela é apresentada a cada arranque enquanto o servidor está no modo de bootstrap, e apenas o bloco mais recente é válido. Aumente a janela com sudo journalctl -u stalwart --since today | grep -A8 'bootstrap mode'. Se o assistente continuar a aparecer depois de concluir a configuração, o ficheiro de configuração está em falta; restaure-o ou monte-o novamente. Se preferir não depender do log, defina STALWART_RECOVERY_ADMIN em /etc/stalwart/stalwart.env e reinicie.
As portas privilegiadas não respondem depois de criar a sua própria unit. Sem AmbientCapabilities=CAP_NET_BIND_SERVICE, o utilizador stalwart não pode associar-se às portas 25, 443, 465 ou 993. O Stalwart ignora cada listener que falha, inicia os restantes e regista um evento registry.build-error com Failed to bind to <address>: <error>. Copie a linha da capability a partir da unit gerada pelo instalador. Se outro servidor de email estiver a usar a porta 25, pare-o e desative-o. A unit do instalador entra em conflito com Postfix, Sendmail e Exim; por isso, iniciar um deles faz o Stalwart parar.
Os certificados nunca são emitidos. O HTTP-01 requer que a porta 80 esteja acessível e encaminhada para um listener HTTP do Stalwart. O TLS-ALPN-01 requer que o próprio Stalwart responda ao handshake TLS na porta 443. Se outro processo ocupar a porta necessária sem encaminhar o desafio, o ACME falha e regista eventos acme.auth-error ou acme.order-invalid. Com DNS manual, a página de resolução de problemas também espera que mta-sts, autoconfig, autodiscover e ua-auto-config, no seu domínio predefinido, resolvam para o servidor, porque esses nomes são incluídos no certificado. As falhas de rede, DNS e validação são repetidas automaticamente de acordo com a política de repetição da tarefa; os pedidos inválidos e os desafios não suportados não são repetidos.
FAQ
O Stalwart substitui o Postfix, o Dovecot e o Rspamd num único VPS?
Sim. Um único binário Rust disponibiliza SMTP, IMAP, POP3, JMAP, CalDAV, CardDAV e WebDAV, além de incluir o filtro de spam, o armazenamento de mensagens e um cliente ACME. Existe uma unidade systemd e um ficheiro de configuração em /etc/stalwart/config.json, em vez de quatro daemons e da configuração de integração entre eles. O que não substitui é a sua zona DNS nem a política do seu fornecedor para a porta 25, que é onde o correio alojado localmente é efetivamente permitido ou bloqueado.
De quanta RAM precisa um servidor de correio Stalwart?
Em 27 October 2026, a página de requisitos do sistema do Stalwart não apresenta um valor por utilizador, e a FAQ diz que não foi publicado um valor medido de utilizadores por nó. A página indica que um servidor inativo se mantém muito abaixo dos seus limites e que o uso de CPU depende do volume de correio e dos inícios de sessão, não do número de contas. O único exemplo calculado é um host com 2 GiB, em que os limites de memória predefinidos totalizam cerca de 2.4 GiB, incluindo duas reservas de 512 MiB que permanecem vazias, exceto se alojar contas muito grandes. maxConnections tem o valor predefinido de 8,192 por listener. Não foi publicado um tamanho mínimo de disco, por isso dimensione o disco para o correio que pretende manter.
Mudar para o Stalwart melhora a entregabilidade do meu correio?
Não. A entregabilidade depende de a porta TCP 25 de saída estar aberta no seu VPS, do DNS inverso do seu IP e dos registos SPF, DKIM e DMARC do seu domínio. O Stalwart suporta DANE, MTA-STS e relatórios SMTP TLS, e pode publicar a sua política MTA-STS, mas estes mecanismos protegem o transporte, não determinam se uma rede recetora confia no seu endereço. Teste a porta 25 com nc -vz -w 5 alt1.aspmx.l.google.com 25 antes de instalar qualquer componente.
O Stalwart inclui webmail?
Não em 27 October 2026. Inclui uma interface web de administração, que é uma coisa diferente. A publicação do roteiro do projeto, de 20 June 2025, diz que o desenvolvimento do webmail começaria quando a versão 1.0 fosse alcançada, em Rust com Dioxus, "muito provavelmente em 2026". A versão 1.0 foi lançada em 26 October 2026 sem webmail, e o blogue do projeto ainda não publicou nenhum anúncio sobre esse componente. Se os seus utilizadores precisam agora de uma caixa de entrada no navegador, implemente o Roundcube em paralelo ou use uma stack que inclua o SOGo.
Contra o que protege a encriptação do Stalwart em repouso?
Encripta as mensagens recebidas de cada utilizador que ativou a opção com a respetiva chave pública OpenPGP ou S/MIME antes de as gravar no disco. Assim, um disco roubado, uma cópia de segurança roubada ou um administrador que leia o armazenamento não conseguem recuperar o conteúdo das mensagens. Não é encriptação ponto a ponto: a mensagem chega em texto simples e é encriptada durante a entrega, por isso todos os saltos anteriores conseguem vê-la. A definição encryptOnAppend por conta está desativada por predefinição, por isso as mensagens acrescentadas pelo cliente permanecem em texto simples, exceto se o servidor permitir a encriptação em repouso e a conta ativar a encriptação de mensagens acrescentadas; na v1.0.1, os rascunhos JMAP e as cópias em Enviados criadas pelo envio JMAP continuam sem encriptação mesmo nesse caso. A documentação indica que os cabeçalhos, como remetente, destinatários e assunto, permanecem legíveis, que o correio armazenado antes do registo da chave não é novamente encriptado e que as pesquisas no corpo e nos anexos não encontram resultados em mensagens encriptadas. O treino antisspam pode manter amostras separadas em texto simples antes da encriptação.