Aumentei a cota de e-mail no pacote e as caixas antigas não mudaram
O caminho documentado para reaplicar a cota nas caixas já existentes de todos os domínios da revenda, conferir no Email Accounts que o número mudou e explicar o caso ao cliente em uma frase.

Resposta curta: a cota de caixa definida no pacote vale apenas para contas criadas depois da alteração; as existentes mantêm o limite gravado na criação. O cPanel documenta 1 script para reaplicar em lote: /usr/local/cpanel/scripts/update_existing_mail_quotas_for_account.
Neste artigo
- Por que a caixa do cliente continua cheia depois de você aumentar o plano
- O script documentado que reaplica a cota nas caixas existentes
- Checklist antes de aplicar em lote
- Rodando em uma conta e em uma lista de contas em arquivo
- Confirmar que mudou de verdade, no painel do cliente
- O que o script não resolve
- A frase pronta que explica ao cliente sem culpar ninguém
- Duas regras para o problema não voltar na sua carteira
Por que a caixa do cliente continua cheia depois de você aumentar o plano
Quando uma conta de e-mail é criada no cPanel, o limite dela é gravado naquele momento, a partir do valor padrão vigente no pacote. Depois disso, a cota passa a ser uma propriedade da caixa, não do pacote.
Consequência prática: você edita o pacote no WHM, sobe a cota padrão de caixa, aplica o pacote na conta e o cliente continua recebendo "mailbox is full". Nada quebrou. As caixas antigas simplesmente mantêm o número que receberam no dia da criação. Só as caixas criadas depois da alteração nascem com o valor novo.
Isso é diferente da cota de disco da conta cPanel, que é um limite único no nível da conta e acompanha o pacote. Aqui são dois limites empilhados:
| Limite | Onde vive | Muda ao reaplicar o pacote |
|---|---|---|
| Cota de disco da conta cPanel | Conta/pacote | Sim |
| Cota padrão de caixa de e-mail do pacote | Pacote | Sim (vale para caixas novas) |
| Cota da caixa já existente | A própria caixa | Não |
A linha que importa é a terceira. É ela que precisa ser reescrita.
O script documentado que reaplica a cota nas caixas existentes
O cPanel distribui um script específico para isso: update_existing_mail_quotas_for_account, documentado em docs.cpanel.net. Ele existe exatamente porque alterar o padrão do pacote não propaga nada para trás.
O caminho, como em todos os scripts do cPanel:
/usr/local/cpanel/scripts/update_existing_mail_quotas_for_account
Ele roda como root, no servidor, via SSH. Revendedor sem shell, portanto, depende do provedor para executá-lo. Se é o seu caso, esta é a parte em que você abre chamado pedindo a execução do script para os seus usuários, citando o nome dele. Pedir "aumentar a cota de e-mail" costuma render uma volta inútil; pedir pelo nome do script resolve na primeira ida.
Antes de rodar, confira no --help a sintaxe da sua versão
A invocação e as opções disponíveis variam entre versões do cPanel. Não decore flag de blog. Rode o script sem argumentos ou com --help e leia o uso impresso na sua versão:
/usr/local/cpanel/scripts/update_existing_mail_quotas_for_account --help
Confira ali se a chamada é por usuário cPanel, se existe modo que abrange todas as contas e se há alguma opção de simulação. Siga o que a sua instalação imprime, não o que você lembra de outra versão.
Checklist antes de aplicar em lote
Rodar em um domínio é trivial. Rodar em todos os clientes da revenda sem checklist é como você descobre, na segunda-feira, que reduziu a cota de uma caixa que estava com 9 GB.
- Anote o valor padrão atual de cada pacote. No WHM, em Packages, o campo de cota de caixa de e-mail. Se pacotes diferentes têm padrões diferentes, o lote precisa ser por pacote, não por servidor inteiro.
- Verifique se você está subindo ou descendo a cota. Se o padrão novo for menor que o atual de alguma caixa, reaplicar vai reduzir essa caixa. Caixa acima do limite novo para de receber. Esse é o único risco real da operação.
- Veja o espaço livre em disco da conta cPanel. Não adianta dar 5 GB por caixa se a conta inteira tem 3 GB. A cota de caixa nunca cria espaço: ela só deixa de barrar antes do limite da conta.
- Faça uma conta piloto. Escolha um cliente seu, interno, rode, confira no painel, só então amplie.
- Avise os clientes se houver qualquer redução. Uma linha de e-mail antes evita três chamados depois.
Rodando em uma conta e em uma lista de contas em arquivo
Para uma conta, a chamada com o usuário cPanel no parâmetro nomeado (usuariodocliente é exemplo fictício, troque pelo real):
/usr/local/cpanel/scripts/update_existing_mail_quotas_for_account --user=usuariodocliente
Se o --help da sua versão imprimir outra forma de passar o usuário, siga o que ele imprime.
Para várias contas, mantenha a lista em arquivo. É mais auditável que um loop que varre o servidor inteiro, e você consegue repetir a execução exata depois:
# contas.txt: um usuario cPanel por linha
while read -r user; do
echo "== $user"
/usr/local/cpanel/scripts/update_existing_mail_quotas_for_account --user="$user"
done < contas.txt | tee /root/cota-email-$(date +%F).log
O tee guarda a saída com data no nome. Quando um cliente disser daqui a dois meses que a caixa dele "nunca foi alterada", você tem a linha.
Como listar só as contas de um pacote com whmapi1 listaccts
Se a mudança foi em um pacote específico, liste as contas daquele pacote pela API do WHM e filtre antes de alimentar o contas.txt:
whmapi1 listaccts --output=jsonpretty | less
Leia os campos user e plan na saída e monte a lista. Prefira conferir com o olho a confiar em um filtro escrito às pressas: a lista errada aqui custa caro.
Confirmar que mudou de verdade, no painel do cliente
Saída limpa do script não é prova. A validação que vale é a que o cliente vê.
- Entre no cPanel da conta, em Email Accounts.
- Localize a caixa reclamante e olhe a coluna de armazenamento. O denominador precisa ser o número novo.
- Clique em Manage na caixa e confira o campo de cota (Storage Space). É ali que o valor efetivo daquela caixa aparece, e é por ele que você compara antes e depois da execução.
- Repita em uma caixa de outro domínio da mesma conta, se houver. Confirma que a aplicação pegou a conta toda, não só o domínio principal.
Se o número exibido continuar o antigo, não insista rodando o script de novo. Reveja se o pacote realmente foi salvo com o valor novo, se a conta está mesmo nesse pacote e se o usuário que você passou é o usuário cPanel correto, não o domínio.
O que o script não resolve
- Caixa com cota individual intencional. Se alguém definiu 20 GB manualmente para a diretoria, reaplicar o padrão do pacote derruba esse valor. Anote essas exceções antes e refaça depois, uma a uma.
- Conta cPanel sem espaço. Cota de caixa maior que o disco livre da conta é número decorativo. O cliente continua travando, agora no limite da conta.
- Disco do servidor cheio. Nenhuma cota ajuda. Esse é outro problema, e aparece em todos os clientes ao mesmo tempo.
- Mensagem presa no cliente de e-mail. Depois de aumentar, peça para o usuário fechar e reabrir o programa de e-mail ou o webmail. Alguns clientes IMAP guardam o aviso de cota da sessão anterior.
A frase pronta que explica ao cliente sem culpar ninguém
Use, adaptando o número:
Funciona porque explica o motivo sem culpar ninguém, nomeia a ação e termina com um lugar onde o cliente confirma sozinho. Economiza a resposta seguinte.
Duas regras para o problema não voltar na sua carteira
Duas regras que evitam a repetição deste problema na sua carteira:
- Toda vez que você editar a cota de caixa de um pacote no WHM, a tarefa não termina no botão Save. Ela termina quando o script rodou nas contas daquele pacote e você conferiu uma caixa no painel.
- Mantenha um arquivo por servidor com pacote, cota de caixa padrão e data da última reaplicação. Três linhas de texto que respondem, meses depois, à pergunta "isso já foi aplicado aqui?".
E o conselho que trabalha contra a venda do upgrade: antes de propor plano maior porque "o e-mail vive cheio", confira a cota efetiva das caixas em Email Accounts. Em muitos casos o espaço já está contratado e só não chegou até a caixa.
Referências
- Documentação oficial (cpanel) — The update_existing_mail_quotas_for_account Script. Consultado em 2026-10-04.