Tutorial completo do aerc no Fedora

Autor: ChatGPT para Pablo Murad
Foco: Fedora + Google Workspace/Gmail + uso diário no terminal
Última revisão: 2026-07-01

1. O que é o aerc?

O aerc é um cliente de e-mail para terminal. Ele é leve, rápido e feito para quem gosta de trabalhar com teclado. Pense nele como uma alternativa moderna ao Mutt/NeoMutt, mas com uma interface mais organizada, abas, suporte forte a IMAP/SMTP, Maildir, Notmuch, JMAP, múltiplas contas, filtros, templates e integração com ferramentas Unix.

Ele não é “bonitinho e automático” como Thunderbird ou Gmail Web. O ponto dele é produtividade: abrir, responder, buscar, arquivar, filtrar, compor e manipular e-mails sem tirar a mão do teclado.

Se você quer só clicar em botão, o aerc não é para você. Se você quer velocidade, controle e integração com terminal, ele é excelente.

2. Instalação no Fedora

No Fedora, instale pelo dnf:

sudo dnf install -y aerc w3m pass gnupg2 isync notmuch

Pacotes:

Confirme a instalação:

aerc -v

Abra:

aerc

Na primeira execução, se ainda não existir configuração, o aerc inicia o assistente de nova conta.

3. Arquivos principais de configuração

O aerc usa normalmente este diretório:

~/.config/aerc/

Os arquivos principais são:

~/.config/aerc/accounts.conf
~/.config/aerc/aerc.conf
~/.config/aerc/binds.conf

Função de cada um:

O arquivo mais sensível é:

~/.config/aerc/accounts.conf

Ele pode conter senha. Portanto, mantenha permissões restritas:

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

4. Configurando Google Workspace / Gmail

Para Google Workspace com domínio próprio, como:

pablo@pablomurad.com

você normalmente usa os servidores do Gmail:

IMAP: imap.gmail.com:993
SMTP: smtp.gmail.com:465

4.1 IMAP, recebimento

No assistente do aerc, use:

Protocol:
IMAP

Username:
pablo@pablomurad.com

Password:
senha de app do Google

Server address:
imap.gmail.com:993

Transport security:
SSL/TLS

A URL final deve ficar parecida com:

imaps://pablo%40pablomurad.com:********@imap.gmail.com:993

O @ do e-mail aparece como %40. Isso é normal.

4.2 SMTP, envio

Na etapa de envio, use:

Username:
pablo@pablomurad.com

Password:
a mesma senha de app do Google

Server address:
smtp.gmail.com:465

Transport security:
SSL/TLS

A URL final deve ficar parecida com:

smtps://pablo%40pablomurad.com:********@smtp.gmail.com:465

Também existe a opção STARTTLS:

smtp+starttls://pablo%40pablomurad.com:********@smtp.gmail.com:587

Para começar, use SSL/TLS na porta 465. É mais simples.

5. Senha de app no Google

Não use a senha normal da sua conta Google.

O caminho correto é gerar uma senha de app.

Passos gerais:

1. Entre na sua Conta Google.
2. Vá em Segurança.
3. Ative a Verificação em duas etapas, se ainda não estiver ativa.
4. Procure por Senhas de app.
5. Crie uma senha para Mail/aerc.
6. Use essa senha no aerc.

Se a opção “Senhas de app” não aparecer, pode ser por um destes motivos:

• 2FA não está ativo.
• O administrador do Google Workspace bloqueou senhas de app.
• A conta exige OAuth em vez de senha de app.
• Há uma política de segurança impedindo clientes externos.

Se o login falhar mesmo com servidor correto, quase sempre o problema é política do Google/Workspace ou senha de app, não o Fedora.

6. Exemplo de accounts.conf para Google Workspace

Arquivo:

nano ~/.config/aerc/accounts.conf

Exemplo simples:

[Google Workspace]
source   = imaps://pablo%40pablomurad.com:SENHA_DE_APP@imap.gmail.com:993
outgoing = smtps://pablo%40pablomurad.com:SENHA_DE_APP@smtp.gmail.com:465
from     = Pablo Murad <pablo@pablomurad.com>
default  = INBOX
copy-to  = [Gmail]/Sent Mail
archive  = [Gmail]/All Mail
trash    = [Gmail]/Trash

Depois:

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

Atenção brutalmente honesta: isso funciona, mas deixar senha em texto dentro do arquivo é uma solução pobre. Para máquina pessoal talvez passe. Para algo sério, use pass.

7. Guardando senha com pass

Instale:

sudo dnf install -y pass gnupg2

Gere uma chave GPG:

gpg --full-generate-key

Liste suas chaves:

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

Inicialize o pass com seu e-mail ou ID da chave:

pass init "pablo@pablomurad.com"

Salve a senha de app:

pass insert email/google-workspace

Teste:

pass email/google-workspace

Agora use no accounts.conf:

[Google Workspace]
source          = imaps://pablo%40pablomurad.com@imap.gmail.com:993
source-cred-cmd = pass email/google-workspace
outgoing        = smtps://pablo%40pablomurad.com@smtp.gmail.com:465
outgoing-cred-cmd = pass email/google-workspace
from            = Pablo Murad <pablo@pablomurad.com>
default         = INBOX
copy-to         = [Gmail]/Sent Mail
archive         = [Gmail]/All Mail
trash           = [Gmail]/Trash

Se o pass pedir senha GPG dentro do aerc e der problema com pinentry, coloque no seu ~/.bashrc, ~/.zshrc ou equivalente:

export GPG_TTY=$(tty)

Depois reinicie o terminal.

8. Primeira navegação

Abra:

aerc

Atalhos básicos:

O aerc tem uma lógica parecida com Vim: teclas simples para ações frequentes, e comandos começando com : para ações explícitas.

9. Comandos com dois pontos

Para executar comandos, aperte:

:

E digite o comando.

Exemplos:

:quit

Sai do aerc.

:compose

Compõe novo e-mail.

:reply

Responde ao e-mail atual.

:reply -a

Responde para todos.

:forward

Encaminha.

:delete

Apaga ou move para lixeira, dependendo da configuração.

:archive

Arquiva.

:search termo

Busca.

:cf INBOX

Troca para a pasta INBOX.

10. Lendo e-mails

Na lista de mensagens:

j / k

move para baixo/cima.

Enter

abre a mensagem.

Dentro da mensagem:

q

volta para a lista.

J

vai para a próxima mensagem.

K

vai para a mensagem anterior.

Se a mensagem tiver partes diferentes, como texto, HTML e anexos:

Ctrl+j
Ctrl+k

alternam entre partes da mensagem, dependendo da configuração.

11. Escrevendo novo e-mail

Use:

:compose

O aerc vai abrir uma tela de composição.

Campos comuns:

To:
Cc:
Bcc:
Subject:

Depois ele abre o editor configurado. Pode ser vim, nano, micro ou outro.

11.1 Se abrir no Vim

Para escrever, aperte:

i

Digite o e-mail.

Para salvar e sair:

Esc
:wq
Enter

11.2 Se abrir no Nano

Digite normalmente.

Para salvar:

Ctrl+O
Enter

Para sair:

Ctrl+X

11.3 Enviar depois de compor

Na tela de composição do aerc, normalmente use:

Ctrl+x

para enviar.

Para cancelar:

Ctrl+q

Se os atalhos forem diferentes no seu setup, aperte ? dentro da tela de composição.

12. Respondendo e encaminhando

Na mensagem aberta ou selecionada:

R

responde.

A

responde para todos.

F

encaminha.

Também pode usar os comandos:

:reply
:reply -a
:forward

Minha recomendação prática:

• Use tecla rápida para tarefas comuns.
• Use comando : quando não lembrar o atalho.

13. Buscando e-mails

Busca simples:

:search palavra

Exemplos:

:search boleto
:search reunião
:search portalidea

Busca por remetente:

:search from:google

Busca por assunto:

:search subject:invoice

Busca combinada, quando o backend suportar:

:search from:cliente subject:contrato

Para limpar busca/filtro, tente:

:clear

ou volte para a pasta:

:cf INBOX

A busca em IMAP depende bastante do servidor. No Gmail, pode funcionar bem, mas não espere a mesma inteligência da interface web do Gmail.

Para busca poderosa local, o caminho mais sério é sincronizar com Maildir e indexar com Notmuch. Isso é outro nível de setup.

14. Pastas no Gmail/Google Workspace

As pastas comuns do Gmail aparecem assim:

INBOX
[Gmail]/All Mail
[Gmail]/Sent Mail
[Gmail]/Drafts
[Gmail]/Trash
[Gmail]/Spam

Para trocar de pasta:

:cf INBOX

Enviados:

:cf "[Gmail]/Sent Mail"

Todos os e-mails:

:cf "[Gmail]/All Mail"

Lixeira:

:cf "[Gmail]/Trash"

Se o nome não funcionar, abra a lista de pastas pelo atalho de troca de mailbox ou veja como o aerc listou as pastas no seu ambiente. Gmail às vezes varia idioma/rótulos dependendo da conta.

15. Arquivar, apagar e marcar

Comandos úteis:

:archive

Arquiva.

:delete

Apaga/move para lixeira.

:read

Marca como lido.

:unread

Marca como não lido.

Atalhos comuns:

Cuidado: atalhos podem variar conforme seu binds.conf. Se algo não bater, use ? ou confira:

nano ~/.config/aerc/binds.conf

16. Anexos

Quando estiver lendo uma mensagem com anexo, use Tab ou os atalhos de partes da mensagem para chegar ao anexo.

Comandos úteis:

:open

Abre o anexo com o programa associado.

:save

Salva o anexo.

Pode também salvar em um caminho específico, dependendo do contexto:

:save ~/Downloads/

Para definir caminho padrão de salvamento, edite aerc.conf:

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

17. Renderização de HTML

E-mails HTML no terminal são sempre meio gambiarra. O aerc consegue renderizar usando filtros, geralmente com w3m.

Instale:

sudo dnf install -y w3m

No aerc.conf, pode existir uma seção de filtros parecida com:

[filters]
text/html = html | colorize
text/plain = colorize

Dependendo da versão/configuração, o filtro HTML pode chamar w3m indiretamente.

Se e-mails HTML aparecerem feios, não surte. Terminal não é navegador. Para newsletters pesadas, banco, marketing e e-mails cheios de tabela, às vezes o Gmail Web ainda será melhor.

18. Configurando editor

O aerc usa o editor definido pelo ambiente ou pelo aerc.conf.

Para usar Nano:

export EDITOR=nano

Para tornar permanente no Bash:

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

Para Zsh:

echo 'export EDITOR=nano' >> ~/.zshrc

Ou configure no aerc.conf:

[compose]
editor=nano

Se você usa Vim:

[compose]
editor=vim

Se você quer algo amigável no terminal, uma boa opção é micro:

sudo dnf install -y micro

[compose]
editor=micro

Minha opinião direta: se você não está afiado no Vim, use micro ou nano. Não complique o setup antes de dominar o cliente.

19. Ajuda interna

Dentro do aerc:

?

abre ajuda contextual.

Também existem comandos de ajuda:

:help

Tutorial interno:

:help tutorial

Configuração:

:help config

Contas:

:help accounts

Atalhos:

:help binds

No terminal, você também pode consultar manuais:

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

20. Personalizando atalhos

Arquivo:

nano ~/.config/aerc/binds.conf

Exemplo conceitual:

[messages]
q = :quit<Enter>
j = :next<Enter>
k = :prev<Enter>
R = :reply<Enter>
A = :reply -a<Enter>
F = :forward<Enter>
D = :delete<Enter>

Não saia mexendo em tudo no primeiro dia. Use o padrão por uma semana. Depois personalize só o que realmente incomodar.

21. Múltiplas contas

Você pode ter várias seções em accounts.conf:

[Google Workspace]
source = imaps://pablo%40pablomurad.com@imap.gmail.com:993
source-cred-cmd = pass email/google-workspace
outgoing = smtps://pablo%40pablomurad.com@smtp.gmail.com:465
outgoing-cred-cmd = pass email/google-workspace
from = Pablo Murad <pablo@pablomurad.com>
default = INBOX
copy-to = [Gmail]/Sent Mail
archive = [Gmail]/All Mail
trash = [Gmail]/Trash

[Runv]
source = imaps://usuario%40runv.club@mail.runv.club:993
source-cred-cmd = pass email/runv
outgoing = smtps://usuario%40runv.club@mail.runv.club:465
outgoing-cred-cmd = pass email/runv
from = Usuario <usuario@runv.club>
default = INBOX
copy-to = Sent
archive = Archive
trash = Trash

Para abrir só uma conta:

aerc -a "Google Workspace"

22. Testando conexão fora do aerc

Antes de culpar o aerc, teste a conexão.

IMAP Gmail:

openssl s_client -connect imap.gmail.com:993

SMTP SSL:

openssl s_client -connect smtp.gmail.com:465

SMTP STARTTLS:

openssl s_client -starttls smtp -connect smtp.gmail.com:587

Se isso falhar, o problema é rede, DNS, firewall, proxy, bloqueio local ou algo fora do aerc.

Se isso funcionar, mas o login falhar, o problema provavelmente é credencial/política do servidor.

23. Logs e diagnóstico

Rode:

aerc > ~/aerc.log 2>&1

Depois veja:

tail -n 100 ~/aerc.log

Também cheque permissões:

ls -la ~/.config/aerc/

Ajuste:

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

Problemas comuns:

24. Setup recomendado para você agora

Para começar sem se perder:

1. Use IMAP direto, não Maildir ainda.
2. Use Google Workspace com senha de app.
3. Use pass assim que confirmar que tudo funciona.
4. Use micro ou nano como editor, não Vim se você não quer brigar com editor.
5. Decore só 10 comandos no começo.
6. Só depois pense em Notmuch, mbsync, busca local e automações.

Instalação prática:

sudo dnf install -y aerc w3m pass gnupg2 micro

Definir editor:

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

Abrir:

aerc

25. Comandos essenciais para decorar

Se você decorar só isso, já consegue usar o aerc no dia a dia.

26. Fluxo diário sugerido

Abrir:

aerc

Ler a caixa:

j/k para navegar
Enter para abrir
q para voltar

Responder:

R

Novo e-mail:

:compose

Buscar algo:

:search cliente

Voltar para entrada:

:cf INBOX

Sair:

:quit

27. Quando vale usar Maildir + Notmuch?

O modo IMAP direto é mais simples. Mas tem limites:

• busca depende do servidor;
• offline é limitado;
• muita coisa fica mais lenta em contas enormes;
• automações locais são mais fracas.

Maildir + Notmuch vale quando você quer:

• busca local absurda de rápida;
• indexar anos de e-mail;
• operar offline;
• criar fluxos Unix sérios;
• tags, scripts e automações.

Mas não comece por aí. Primeiro faça o aerc funcionar com IMAP. Depois evolua.

28. Resumo brutalmente honesto

O aerc é ótimo, mas ele cobra pedágio: você precisa aprender atalhos, entender configuração e aceitar que e-mail no terminal não é igual Gmail Web.

A vantagem é clara: depois que você pega o jeito, fica muito rápido. Para quem vive no terminal, administra servidor, programa e usa SSH o tempo todo, faz sentido.

A ordem certa é:

1. Instalar.
2. Configurar uma conta.
3. Ler e responder e-mails.
4. Ajustar editor.
5. Colocar senha no pass.
6. Personalizar atalhos.
7. Só depois mexer com Notmuch/Maildir.

Tentar montar o setup perfeito no primeiro dia é perda de tempo. Faça funcionar, use de verdade, depois refine.

29. Referências úteis

• Site oficial: https://aerc-mail.org/
• Documentação comunitária: https://aerc-docs.com/
• Quickstart: https://aerc-docs.com/getting-started/quickstart/
• Configuração de contas: https://aerc-docs.com/reference/aerc-accounts.5/
• Configuração geral: https://aerc-docs.com/reference/aerc-config.5/
• ArchWiki: https://wiki.archlinux.org/title/Aerc