# 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.

> 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.

João Rizzon · 2026-10-13 · Revenda

---

## 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](https://docs.cpanel.net/whm/scripts/the-update_existing_mail_quotas_for_account-script/). 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:

```bash
/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:

```bash
/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):

```bash
/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:

```bash
# 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`:

```bash
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:

> **** "A cota de cada caixa é gravada no momento em que ela é criada. Quando aumentamos o limite do plano, o valor novo passa a valer para as caixas criadas dali em diante, e as antigas continuam com o limite original. Rodamos hoje o procedimento oficial do cPanel que reaplica o limite novo nas caixas já existentes. A sua caixa agora está com X GB, você pode conferir em Email Accounts no cPanel."

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.

