Deixar cPanel e webmail em português em toda a revenda
Como aplicar pt_br em lote pelo WHM, deixar o Roundcube abrindo em português e responder ao cliente que reclama das mensagens que continuam em inglês.

Resposta curta: padronize pelo WHM em vez de ajustar conta por conta: defina `locale=pt_br` como padrão em Tweak Settings e na criação de contas, aplique em lote nas antigas com `whmapi1 modifyacct` sobre uma lista revisada, e saiba que bounces do Exim e erros de PHP seguem em inglês por virem de fora do painel.
Neste artigo
- O que o locale da conta cPanel traduz e o que fica fora do alcance dele
- As duas frentes que fazem a conta nova já nascer em pt_br
- Trocar o locale das contas antigas em lote com whmapi1 modifyacct
- Webmail em português, e por que a caixa antiga continua em inglês
- Bounce, erro de PHP e string sem tradução: de onde vem cada mensagem em inglês
- Checklist para padronizar o idioma de toda a revenda
- A resposta pronta para o cliente que reclama de mensagem em inglês
O que o locale da conta cPanel traduz e o que fica fora do alcance dele
No cPanel, idioma é um atributo da conta, não do navegador. Cada conta cPanel carrega um locale (no caso do português do Brasil, pt_br), e é ele que decide em que língua a interface aparece quando o cliente faz login. Trocar o idioma no rodapé do cPanel muda uma conta. Quem administra uma revenda com dezenas de clientes não quer fazer isso uma por uma, e nem quer que a conta criada amanhã nasça em inglês de novo.
O locale alcança a interface do cPanel, os nomes dos ícones, os assistentes e boa parte das mensagens geradas pelo próprio cPanel. Ele não alcança o texto que vem de fora: retorno do Exim, do Dovecot, do MySQL, do PHP e de plugins de terceiros continuam no idioma em que foram escritos. Isso não é falha de configuração, é limite de escopo, e é a parte que mais gera reclamação de cliente. Volto nela no fim.
A documentação oficial do recurso de idiomas no WHM está em Configure Application Locales, que é também onde se editam e se criam traduções customizadas.
As duas frentes que fazem a conta nova já nascer em pt_br
Duas frentes, e vale cuidar das duas porque elas cobrem caminhos diferentes de criação de conta. Aviso de método: a documentação que citei acima cobre a edição de locales, não os caminhos de Tweak Settings nem os parâmetros da API de contas. O que vem abaixo é prática de operação, conferida no WHM e na saída do whmapi1, e os nomes de menu e de parâmetro mudam entre versões. Confira o que aparece na sua tela antes de automatizar.
Onde fica o locale padrão do servidor no Tweak Settings
No WHM, em Server Configuration » Tweak Settings, busque por locale no campo de pesquisa da própria página. A opção de locale padrão define o idioma atribuído a contas criadas sem que o idioma seja informado explicitamente. Se o seu WHM não expuser essa opção (o conjunto de tweaks varia conforme versão e perfil do servidor, e em revenda você depende do que o provedor habilitou), siga pela frente seguinte, que funciona em qualquer caso.
Passar locale=pt_br no formulário de criação e na API de billing
Ao criar conta em Account Functions » Create a New Account, o formulário tem o campo de locale. Deixe Portuguese (Brazil) selecionado. Se você cria contas por API ou por integração com o sistema de billing, passe o parâmetro explicitamente, que é mais confiável que depender de padrão global:
whmapi1 createacct user=exemplo domain=exemplo.com.br \
plan=revenda_basico locale=pt_br
O valor exemplo acima é fictício, troque pelos seus. O que importa é o par locale=pt_br: com ele na chamada, nenhuma mudança futura de padrão global quebra o seu fluxo.
Trocar o locale das contas antigas em lote com whmapi1 modifyacct
Para as contas antigas, o caminho manual é WHM » Account Functions » Modify an Account, trocar o locale e salvar. Para dezenas de contas, use a API. Vale a mesma ressalva: modifyacct com locale= é uso de operação, não procedimento transcrito da documentação citada; valide o retorno da chamada em vez de confiar no silêncio.
Primeiro liste e confira. Nunca rode o loop antes de ver a saída da listagem:
# 1. listar usuário, dono e locale atual das contas que você enxerga
whmapi1 --output=json listaccts \
| jq -r '.data.acct[] | [.user, .owner, .locale] | @tsv'
# 2. filtrar pelo seu usuário de revenda e guardar em arquivo para revisar
whmapi1 --output=json listaccts \
| jq -r '.data.acct[] | select(.owner=="seurevendedor") | select(.locale!="pt_br") | .user' \
> contas-pt-br.txt
# 3. conferir o locale atual de uma conta específica
whmapi1 --output=json accountsummary user=exemplo | jq '.data.acct[0].locale'
O filtro importa por dois motivos. listaccts sem filtro devolve tudo que o seu usuário enxerga, não só o que é seu, e o laço grava pt_br em cima de quem talvez tenha escolhido outro idioma de propósito (cliente que prefere inglês, ou espanhol). Abra o contas-pt-br.txt, tire quem não deve entrar e só então rode o lote.
Confirmada a lista, aplique:
while read -r u; do
[ -z "$u" ] && continue
echo "== $u"
whmapi1 --output=json modifyacct user="$u" locale=pt_br \
| jq -r '.metadata.result, .metadata.reason'
done < contas-pt-br.txt | tee lote-locale-$(date +%F).log
O jq no fim imprime 1 e OK por conta: se aparecer 0 com uma razão, você tem o erro na tela em vez de um loop silencioso. Causas comuns de falha: conta suspensa, usuário fora da sua revenda e permissão de reseller sem o privilégio de modificar contas. Nesse último caso, só o administrador do servidor resolve.
Se você não tem acesso a shell no WHM, faça por Modify an Account mesmo, e priorize os clientes que mais abrem chamado.
Webmail em português, e por que a caixa antiga continua em inglês
O webmail herda o locale da conta cPanel, então a troca acima já faz o Roundcube abrir em português para quem nunca mexeu na preferência. A pegadinha é o endereço de e-mail que já entrou no Roundcube alguma vez: o Roundcube guarda preferência por caixa postal, e a preferência salva vence o padrão da conta.
Para essas caixas, o próprio usuário resolve em Roundcube » Configurações » Preferências » Interface de usuário » Idioma, selecionando Português (Brasil) e salvando. Vale avisar o cliente de que a mudança é por caixa postal, não por domínio: trocar em contato@ não troca em financeiro@.
Na interface jupiter, o seletor de idioma do cPanel fica no rodapé da página e no menu de usuário. É o caminho para o cliente que você não quer tirar do autoatendimento.
Bounce, erro de PHP e string sem tradução: de onde vem cada mensagem em inglês
| Origem da mensagem | Segue o locale pt_br | Observação |
|---|---|---|
| Interface e ícones do cPanel | Sim | Traduzido pelo cPanel |
| Interface do Roundcube | Sim, salvo preferência salva na caixa | Preferência por caixa postal vence |
| Retorno de entrega do Exim (bounce) | Não | Texto do servidor de e-mail, em inglês |
| Erro de login do Dovecot | Não | Texto do servidor IMAP/POP |
| Erro de PHP, MySQL, WordPress plugin | Não | Vem da aplicação, não do painel |
| String nova do cPanel ainda sem tradução | Não | Cai no inglês de origem |
Esse último caso tem conserto, mas não na sua mão se você é revendedor: WHM » Locales » Configure Application Locales é área de administrador do servidor, acessível com WHM root. Em uma conta de reseller o item não aparece. Lá dá para editar as frases de um locale e cadastrar tradução própria para strings específicas, conforme a documentação do cPanel. Se a frase incomoda de verdade, o caminho é pedir ao provedor, mesmo caminho do Tweak Settings. E pese o custo antes de pedir: tradução customizada é manutenção sua a cada atualização. Na prática, só compensa para uma frase que aparece em tela que o seu cliente usa toda semana.
Checklist para padronizar o idioma de toda a revenda
- Definir o locale padrão em Tweak Settings, se a opção existir no seu WHM.
- Passar
locale=pt_brna criação de conta, no WHM e na integração de billing. - Gerar a lista filtrada, revisar o arquivo e rodar o laço de
modifyacctguardando a saída em log. - Reconferir uma amostra por
accountsummarydepois do lote. - Abrir o webmail de uma caixa antiga e de uma caixa nova, para ver a diferença entre preferência salva e padrão herdado.
- Incluir no e-mail de boas-vindas ao cliente a instrução de trocar o idioma do Roundcube por caixa postal.
- Repetir o lote de
modifyacctquando migrar contas de outro servidor, porque a migração traz o locale de origem.
Vale uma observação contra o meu próprio interesse: se o cliente reclama de "painel em inglês" mas o que ele vê em inglês é bounce de e-mail, nenhuma configuração de painel resolve. Leia a mensagem antes de mexer no locale.
A resposta pronta para o cliente que reclama de mensagem em inglês
Use esta, ou uma variação dela, quando vier a reclamação de mensagem em inglês depois da troca:
A última linha é a que fecha o assunto de verdade: o cliente não quer tradução, quer entender o que está acontecendo. Resolver o significado da mensagem encerra o chamado melhor do que traduzir a mensagem.
Referências
- Documentação oficial (cpanel) — Configure Application Locales (WHM). Consultado em 2026-10-09.