Tutorial completo do aerc no Linux/Armbian

Autor/compilação: Pablo Murad + ChatGPT
Ambiente de referência: Orange Pi 3B / Armbian Ubuntu resolute / ARM64
Versão instalada no teste: aerc 0.21.0 +notmuch-5.6.0
Data: 2026-06-24

1. O que é o aerc

O aerc é um cliente de e-mail para terminal. Ele roda em TUI, ou seja, dentro do shell, sem interface gráfica. É feito para quem gosta de teclado, SSH, servidores, máquinas headless e fluxo Unix.

Ele suporta múltiplas contas e pode trabalhar com IMAP, SMTP, Maildir, Notmuch, mbox e JMAP. Na prática, isso permite tanto um uso simples, conectado direto ao servidor IMAP, quanto um uso mais avançado com sincronização local, busca indexada e automações.

Resumo brutalmente honesto:

Se você quer clicar em botões bonitos, não use aerc.
Se você vive no terminal, ele é excelente.
Se você quer aprender e-mail do jeito Unix, ele é uma ótima escolha.
Se você quer algo “abre e sai usando em 30 segundos”, use Thunderbird.

2. Instalação no Armbian/Ubuntu

No seu Orange Pi, a instalação foi feita assim:

sudo apt update
apt policy aerc
sudo apt install -y aerc w3m gnupg pass notmuch isync
aerc -v

Pacotes instalados:

aerc      cliente de e-mail principal
w3m       navegador terminal usado para renderizar HTML
 gnupg    suporte a GPG/OpenPGP
pass      gerenciador de senhas simples baseado em GPG
notmuch   indexador e mecanismo de busca local
isync     sincronizador IMAP/Maildir, usado em setups offline

Verificação:

aerc -v

Saída esperada no seu caso:

aerc 0.21.0 +notmuch-5.6.0

3. Primeira execução

Rode:

aerc

Na primeira execução, o aerc cria os arquivos de configuração em:

~/.config/aerc/

Arquivos principais:

~/.config/aerc/aerc.conf       configuração geral
~/.config/aerc/accounts.conf   contas de e-mail
~/.config/aerc/binds.conf      atalhos de teclado
~/.config/aerc/stylesets/      temas/estilos
~/.config/aerc/templates/      modelos de mensagens

Para conferir:

tree ~/.config/aerc

Se quiser iniciar o assistente de conta dentro do aerc:

:new-account

Para sair:

:quit

ou pressione:

Dependendo do contexto, q fecha a aba atual; :quit é mais explícito.

4. Filosofia da interface

O aerc funciona como uma mistura de:

cliente de e-mail;
editor modal estilo Vim;
terminal embutido;
sistema de comandos com :;
painel de contas, pastas, lista de mensagens e visualizador.

A ideia é simples:

contas/pastas -> lista de mensagens -> visualização -> resposta/composição

Você navega quase tudo pelo teclado.

5. Ajuda integrada

Dentro do aerc, use:

:help

Para abrir o tutorial:

:help tutorial

Para ver configuração:

:help config

Para contas:

:help accounts

Para atalhos ativos:

:help keys

No shell, você também pode usar:

man aerc
man aerc-tutorial
man aerc-config
man aerc-accounts
man aerc-binds

Esses manuais são importantes porque o aerc muda com o tempo. Tutorial de blog velho na internet pode quebrar sua configuração.

6. Estrutura básica de conta IMAP/SMTP

O arquivo sensível é:

~/.config/aerc/accounts.conf

Ele pode conter senhas. Portanto:

chmod 600 ~/.config/aerc/accounts.conf

Exemplo genérico:

[MinhaConta]
source = imaps://usuario%40dominio.com.br@imap.dominio.com.br:993
outgoing = smtps://usuario%40dominio.com.br@smtp.dominio.com.br:465
default = INBOX
from = Seu Nome <usuario@dominio.com.br>
copy-to = Sent
archive = Archive

Atenção ao detalhe feio, mas necessário:

usuario@dominio.com.br

em URL vira:

usuario%40dominio.com.br

O @ do usuário precisa ser escapado como %40, senão a URL fica ambígua.

7. Exemplo para Gmail

Para Gmail, não use sua senha normal. Use senha de aplicativo.

Configuração típica:

[Gmail]
source = imaps://seuemail%40gmail.com@imap.gmail.com:993
outgoing = smtps://seuemail%40gmail.com@smtp.gmail.com:465
default = INBOX
from = Seu Nome <seuemail@gmail.com>
copy-to = [Gmail]/Sent Mail
archive = [Gmail]/All Mail

Problemas comuns no Gmail:

Usar senha normal em vez de senha de aplicativo.
Esquecer de ativar 2FA antes de criar senha de app.
Pastas com nomes diferentes em português.
Sent Mail variar conforme idioma/configuração.

Para evitar chute, depois de configurar a conta, veja as pastas reais no painel lateral do aerc.

8. Exemplo para domínio próprio

Exemplo usando mail.seudominio.com.br:

[Dominio]
source = imaps://usuario%40seudominio.com.br@mail.seudominio.com.br:993
outgoing = smtps://usuario%40seudominio.com.br@mail.seudominio.com.br:465
default = INBOX
from = Pablo Murad <usuario@seudominio.com.br>
copy-to = Sent
archive = Archive

Se o servidor usa SMTP STARTTLS em vez de SMTPS:

outgoing = smtp+starttls://usuario%40seudominio.com.br@smtp.seudominio.com.br:587

Portas comuns:

IMAP SSL/TLS:      993
SMTP SSL/TLS:      465
SMTP STARTTLS:     587
IMAP sem TLS:      143  não recomendado
SMTP sem TLS:      25   não recomendado para cliente final

9. Senhas: jeito simples e jeito correto

9.1 Jeito simples

O jeito simples é deixar o aerc pedir a senha quando abrir.

Vantagem:

não grava senha em arquivo.

Desvantagem:

precisa digitar sempre.

9.2 Jeito direto no arquivo

Alguns setups permitem senha diretamente na URL, mas isso é ruim:

source = imaps://usuario:senha@imap.exemplo.com:993

Não recomendo. Se alguém ler seu accounts.conf, acabou.

9.3 Jeito melhor: `pass`

Inicialize o GPG:

gpg --full-generate-key

Veja a chave:

gpg --list-secret-keys --keyid-format=long

Inicialize o pass:

pass init "SEU_ID_DA_CHAVE"

Salve uma senha:

pass insert email/gmail

Depois, no accounts.conf, você pode usar comando para obter senha, dependendo da sintaxe suportada pela versão/configuração. Consulte:

man aerc-accounts

ou dentro do aerc:

:help accounts

Não force configuração de senha por blog aleatório. A sintaxe de credenciais é uma daquelas áreas em que versão importa.

10. Comandos essenciais dentro do aerc

Comandos começam com :.

:help              abre ajuda
:help keys         mostra atalhos ativos
:help tutorial     abre tutorial integrado
:quit              sai
:new-account       abre assistente de nova conta
:compose           cria novo e-mail
:reply             responde e-mail
:reply -a          responde a todos
:forward           encaminha e-mail
:delete            apaga mensagem
:archive           arquiva mensagem
:search termo      busca mensagens
:clear             limpa busca/filtro atual
:cf Pasta          muda para uma pasta

Nem todos os comandos fazem sentido em todos os contextos. Se um comando falhar, provavelmente você está no painel errado.

11. Atalhos comuns

Os atalhos podem variar conforme binds.conf, então confirme com:

:help keys

Atalhos geralmente úteis:

j              desce
k              sobe
Enter          abre mensagem
q              fecha/volta/sai do contexto atual
R              responder
A              responder a todos
F              encaminhar
D              deletar
C              compor nova mensagem
/              buscar
n              próxima mensagem ou próximo resultado
p              mensagem anterior ou resultado anterior
Tab            alterna entre painéis/abas

Se você já usa Vim, vai se sentir em casa. Se não usa, aceite o atrito inicial. Cliente de e-mail em terminal sem atalhos é só sofrimento com etapas extras.

12. Escrever e enviar e-mail

Para criar mensagem nova:

:compose

O aerc abre seu editor configurado, normalmente vim, nano ou o editor definido na variável EDITOR.

Para definir o editor no shell:

export EDITOR=nano

Para tornar permanente:

echo 'export EDITOR=nano' >> ~/.bashrc
source ~/.bashrc

Se preferir Vim:

echo 'export EDITOR=vim' >> ~/.bashrc
source ~/.bashrc

Fluxo típico:

:compose
preenche destinatário, assunto e corpo;
salva e fecha o editor;
aerc mostra tela de revisão;
confirma envio.

No Vim:

Esc
:wq

No nano:

Ctrl+O
Enter
Ctrl+X

13. Responder mensagens

Abra uma mensagem e use:

:reply

Responder para todos:

:reply -a

Encaminhar:

:forward

Na prática, aprenda os atalhos configurados para essas ações com:

:help keys

14. Anexos

Para ver anexos, abra a mensagem e navegue pelas partes da mensagem.

Comandos úteis variam por contexto, então use:

:help keys

Normalmente você poderá:

abrir anexo;
salvar anexo;
alternar entre partes texto/HTML;
visualizar estrutura MIME.

Configure um diretório padrão de downloads em aerc.conf, se desejar.

Exemplo conceitual:

[general]
default-save-path = ~/Downloads

Crie a pasta:

mkdir -p ~/Downloads

15. HTML no terminal

Você instalou w3m, que o aerc pode usar como filtro para renderizar HTML em texto.

Verifique:

which w3m

Se e-mails HTML aparecerem crus, cheque:

man aerc-config

Procure por filtros:

man aerc-config | grep -i filter -A 20

Dentro do aerc:

:help config

HTML em terminal nunca será perfeito. Newsletter cheia de tabela, botão e tracking pixel vai parecer um cadáver tipográfico. Isso é normal.

16. Busca

Busca simples dentro do aerc:

:search palavra

Limpar busca:

:clear

Com Notmuch, você pode montar um setup mais poderoso com e-mails sincronizados localmente. Isso é avançado e depende de Maildir + isync/mbsync.

Para começar com IMAP direto, não complique. Faça o básico funcionar primeiro.

17. Uso online vs uso offline

17.1 Online simples

O aerc acessa IMAP direto.

Vantagens:

configuração mais simples;
menos peças;
bom para começar.

Desvantagens:

depende da conexão;
busca pode ser limitada pelo servidor;
menos controle local.

17.2 Offline avançado

Fluxo avançado:

isync/mbsync -> Maildir local -> notmuch -> aerc

Vantagens:

e-mails locais;
busca rápida;
automação Unix;
backup mais fácil.

Desvantagens:

configuração mais trabalhosa;
mais pontos de falha;
exige entender Maildir.

Recomendação honesta: comece com IMAP direto. Só vá para Maildir/Notmuch quando sentir uma dor real.

18. Configuração geral: `aerc.conf`

Arquivo:

~/.config/aerc/aerc.conf

Exemplo básico:

[general]
default-save-path = ~/Downloads
unsafe-accounts-conf = false

[ui]
index-format = %D %-17.17n %Z %s
sidebar-width = 20

[viewer]
pager = less -R

Não copie configurações gigantes de internet sem entender. O aerc é poderoso, mas uma configuração “bonita” e quebrada continua quebrada.

19. Atalhos: `binds.conf`

Arquivo:

~/.config/aerc/binds.conf

Formato:

[contexto]
tecla = :comando

Exemplo conceitual:

[messages]
j = :next
k = :prev
q = :quit

Antes de mexer:

cp ~/.config/aerc/binds.conf ~/.config/aerc/binds.conf.bak

Se quebrar:

mv ~/.config/aerc/binds.conf.bak ~/.config/aerc/binds.conf

20. Temas e aparência

Temas ficam em:

~/.config/aerc/stylesets/

Você pode mudar cores, destaque de mensagens, status bar etc.

Mas, de novo: primeiro faça receber/enviar funcionar. Tema antes de conta funcional é procrastinação com maquiagem.

21. Checklist de configuração de uma conta

Antes de culpar o aerc, valide:

[ ] endereço IMAP correto
[ ] porta IMAP correta
[ ] SSL/TLS correto
[ ] endereço SMTP correto
[ ] porta SMTP correta
[ ] usuário correto
[ ] @ escapado como %40 na URL
[ ] senha correta ou senha de app
[ ] 2FA resolvido, se houver
[ ] pastas Sent/Archive existem
[ ] accounts.conf com permissão 600

Comando:

chmod 600 ~/.config/aerc/accounts.conf

22. Testes de rede

Teste DNS:

getent hosts imap.gmail.com
getent hosts smtp.gmail.com

Teste porta IMAP TLS:

openssl s_client -connect imap.gmail.com:993 -servername imap.gmail.com

Teste SMTP TLS:

openssl s_client -connect smtp.gmail.com:465 -servername smtp.gmail.com

Para sair do openssl s_client:

Ctrl+C

Se nem conecta, o problema não é o aerc. É rede, DNS, firewall, provedor ou porta bloqueada.

23. Logs e diagnóstico

Rode o aerc salvando log:

aerc > ~/aerc.log 2>&1

Depois veja:

tail -n 100 ~/aerc.log

Também confira versão:

aerc -v

Configurações:

ls -la ~/.config/aerc

Permissões:

stat ~/.config/aerc/accounts.conf

24. Problemas comuns

24.1 Não autentica

Causas prováveis:

senha errada;
precisa de senha de aplicativo;
usuário mal escapado;
servidor exige OAuth2;
IMAP desativado no provedor.

24.2 Entra, mas não envia

Causas prováveis:

SMTP errado;
porta errada;
STARTTLS vs SSL/TLS confundido;
provedor bloqueia envio externo;
from não bate com conta autenticada.

24.3 HTML aparece horrível

Normal. Instale w3m, configure filtros e aceite que terminal não é navegador.

24.4 Pastas Sent/Archive não funcionam

O nome real da pasta pode ser diferente.

Exemplos:

Sent
Sent Mail
[Gmail]/Sent Mail
Enviados
INBOX.Sent
Archive
Archives
[Gmail]/All Mail

Veja a lista de pastas no aerc antes de configurar no chute.

24.5 Teclas não fazem o que o tutorial diz

Use:

:help keys

O seu binds.conf manda mais que qualquer tutorial.

25. Fluxo recomendado para você

Como seu ambiente é Orange Pi + Armbian + terminal, eu faria assim:

usar IMAP/SMTP direto primeiro;
testar receber;
testar enviar para você mesmo;
configurar HTML com w3m;
ajustar atalhos mínimos;
só depois pensar em Maildir, Notmuch e sync local.

Ordem errada seria:

mexer em tema;
configurar Notmuch;
inventar GPG;
sincronizar offline;
só então testar login.

Isso é receita clássica para perder uma tarde e não ler um único e-mail.

26. Comandos rápidos de referência

# instalar
sudo apt update
sudo apt install -y aerc w3m gnupg pass notmuch isync

# versão
aerc -v

# abrir
aerc

# ver configs
ls -la ~/.config/aerc
tree ~/.config/aerc

# proteger accounts.conf
chmod 600 ~/.config/aerc/accounts.conf

# abrir manuais
man aerc
man aerc-tutorial
man aerc-config
man aerc-accounts
man aerc-binds

# log
aerc > ~/aerc.log 2>&1
tail -n 100 ~/aerc.log

Dentro do aerc:

:help
:help tutorial
:help keys
:help accounts
:new-account
:compose
:reply
:reply -a
:forward
:search termo
:clear
:quit

27. Mini roteiro de aprendizado em 30 minutos

Minutos 0-5

Abra:

aerc

Leia:

:help tutorial

Minutos 5-10

Veja atalhos:

:help keys

Navegue sem configurar nada, só para entender a interface.

Minutos 10-20

Configure uma conta com:

:new-account

ou edite:

nano ~/.config/aerc/accounts.conf

Minutos 20-25

Teste receber e abrir mensagens.

Minutos 25-30

Envie um e-mail para você mesmo.

Se isso funcionar, você venceu a parte difícil.

28. Fontes consultadas

Site oficial do aerc: https://aerc-mail.org/
Documentação de instalação/quickstart: https://aerc-docs.com/getting-started/quickstart/
Referência de contas: https://aerc-docs.com/reference/aerc-accounts.5/
Referência de atalhos: https://aerc-docs.com/reference/aerc-binds.5/
README do projeto: https://github.com/rjarry/aerc
Manpages Ubuntu/Arch consultadas para confirmar comandos e estrutura.

29. Conclusão

O aerc é uma ferramenta excelente para Linux em terminal, especialmente em servidor ou SBC como Orange Pi. Mas ele recompensa disciplina: configure uma conta simples primeiro, valide envio e recebimento, e só depois adicione camadas avançadas.

A regra é simples:

funcionar primeiro, ficar elegante depois

Related documents