Problemas comuns e o que fazer

Procure a mensagem que apareceu: cada item traz a causa e o que fazer.

Atualizado em 9 de outubro de 2026

O painel e a máquina

O link de acesso não abre o painel

A página diz "Este link não vale mais" e explica: "Links de acesso valem por pouco tempo e funcionam uma vez."

O link para entrar vale 15 minutos e funciona uma vez. Clique em Mandar um link novo, na própria página, ou peça outro em nimucloud.com/painel.

O painel pede para entrar de novo

A tela de entrada diz "Sessão encerrada. Peça um novo link de acesso."

A sessão do painel acabou, ou você usou Encerrar todas as sessões em outro aparelho. Escreva o e-mail da conta e peça um link novo.

A máquina parou e o painel pede os seus dados

O painel diz "Máquina parada: faltam os dados do titular."

Passaram as 24 horas dos dados do titular. Complete o CPF, a data de nascimento e o endereço em Seus dados: a conta volta e a máquina liga sozinha. Os arquivos continuam guardados. Veja Começar.

O CPF ou a data de nascimento é recusado

O formulário responde "Esse CPF já está em outra conta da Nimu. Se ele é seu, escreva para [email protected]." ou "O titular da conta precisa ter 18 anos ou mais. Confira a data de nascimento."

O teste é para maiores de 18 anos, com uma conta por CPF de cada vez. Se o CPF é seu e está em outra conta, escreva para [email protected].

O endereço da máquina mostra "A máquina não respondeu"

A página diz "A máquina não respondeu" e "Ela pode estar desligada; ligue pelo painel."

No painel, na vista Máquina, veja o estado da máquina. Se ela está desligada, clique em Ligar a máquina e abra o endereço de novo.

A Nimu desligou a máquina

O painel diz "Máquina desligada pela equipe da Nimu."

O motivo aparece no painel ou vai para o seu e-mail. Os arquivos continuam guardados, e a máquina fica desligada enquanto a conta estiver suspensa.

Não dá para guardar outro ponto

A vista Pontos para voltar diz "3 de 3 pontos manuais guardados. Apague um para guardar outro."

O teste guarda até 3 pontos manuais. Apague um na lista e guarde o novo. Se a frase for "Aguarde a ação em andamento para guardar um ponto.", a máquina está terminando outra ação: ela faz uma de cada vez.

Não dá para trocar o tipo da máquina de novo

O painel responde, com a hora em que a troca volta a valer: "Você trocou o tipo há pouco. Dá para trocar de novo às 14:30 de 09/10 (horário de Brasília): é uma troca por hora."

Espere a hora indicada. Cada troca apaga a máquina atual e cria outra.

Publicar

O endereço mostra "App fora do ar no momento"

A página diz "App fora do ar no momento" e "Tente de novo em alguns minutos. Se o app é seu, confira no painel se a máquina está ligada e se o app está rodando na porta publicada."

O app publicado roda na Sandbox. Confira três coisas:

A Sandbox está ligada.
O processo do app está rodando. Se ele parou quando você fechou o terminal, suba de novo numa sessão do tmux.
O app escuta em 0.0.0.0. Rode nimu porta com a porta publicada.

A porta escuta só em localhost

$ nimu porta 5173
A porta 5173 escuta só em 127.0.0.1 (localhost): a borda da Nimu não chega nela.
Reinicie o app escutando em 0.0.0.0. Vite: npm run dev -- --host 0.0.0.0 (ou server.host: true no vite.config). No Vite, ponha também '.nimucloud.app' em server.allowedHosts.

O app funciona no terminal, mas a Nimu não chega nele. Reinicie o servidor escutando em 0.0.0.0. A tabela de Publicar mostra como fazer em cada servidor.

Nada escuta na porta

$ nimu porta 3001
Nada escuta na porta 3001 agora.
Suba o app nessa porta escutando em 0.0.0.0 (por exemplo: npm run dev -- --host 0.0.0.0 --port 3001) e confira de novo com nimu porta 3001.

O app não está rodando, ou roda em outra porta. Suba o app e confira de novo.

A porta é recusada

$ nimu publicar --porta 8080
nimu: a porta 8080 é a do editor da máquina (code-server); use a porta do seu app, como 3000
$ nimu publicar --porta 80
nimu: use uma porta de 1024 a 65535, como 3000

A porta do app vai de 1024 a 65535, menos as que a máquina usa: 8080, 9119, 9120, 9121 e 9200.

A conta chegou no limite de apps

$ nimu publicar --porta 3000
nimu: O teste grátis publica até 3 apps. Remova um para publicar outro.

A cota soma os apps da Sandbox e os da produção. Remova um app que não usa mais, com nimu remover ID ou pelo painel, e publique de novo.

Publicar pede os dados do titular

$ nimu publicar --porta 3000
nimu: Complete os seus dados do titular para publicar: https://nimucloud.com/painel/

Publicar só funciona com o CPF, a data de nascimento e o endereço completos. A pessoa completa no painel, em Seus dados.

O comando não acha o app

$ nimu app zzzz9999
nimu: não achei o app "zzzz9999" nesta conta; os apps são: k7m2p9xq (porta 8000), b7wq3hzn (porta 5173), m4rk9t2q (porta 4000)

O id tem 8 letras e é o começo do endereço do app. A própria mensagem lista os apps da conta, e nimu apps mostra todos.

Quem visita o app

Estas são as páginas que a Nimu mostra a quem abre o endereço de um app quando algo não vai bem.

"App não encontrado": "Confira o endereço. O app pode ter saído do ar ou mudado de endereço." O endereço não existe, o app foi removido, ou é um app de produção que ainda não tem versão no ar. Um endereço removido não volta.
"Este app foi tirado do ar": "Ele não está mais disponível neste endereço." A Nimu tirou o app do ar, ou a conta está suspensa. Se o app é seu, veja o motivo no painel.
"Envio grande demais": "Este endereço aceita envios de até 100 MB." O pedido passou desse tamanho.
"Muitos pedidos": "Este app recebeu pedidos demais em pouco tempo. Espere um pouco e tente de novo." O app passou dos pedidos por segundo, ou aquele visitante passou dos pedidos ou das conexões dele.
"O app está ocupado": "Ele recebeu pedidos demais ao mesmo tempo. Espere um pouco e tente de novo." O app chegou ao máximo de conexões abertas.
"Senha incorreta. Confira e tente de novo.": A senha do app não confere. Quem publicou pode trocar a senha com nimu app ID --gerar-senha ou pelo painel.
"Muitas tentativas. Espere alguns minutos e tente de novo.": O visitante mandou a senha vezes demais. São 20 envios a cada 15 minutos.

Os números estão em Limites do teste.

O app da produção ainda está subindo

No app que roda na produção, o visitante pode ver uma destas frases:

"O app está iniciando. Tente de novo em alguns segundos.": O app estava dormindo e está acordando. É o esperado depois de 15 minutos sem visita.
"O app não conseguiu iniciar. Tente de novo em alguns minutos.": O app caiu ao subir. Veja o motivo com nimu logs ID.
"O app não cabe na memória da máquina agora. Tente de novo em alguns minutos.": Os apps acordados já ocupam a memória que a máquina de produção tem para apps. Este sobe quando outro dormir. Para não depender disso, diminua o memoria_mb de um app ou remova um app que não usa.
"O app não respondeu. Tente de novo em alguns segundos.": O app não atendeu àquele pedido: ele pode ter caído, ou não escuta na porta do nimu.toml. Veja o que ele escreveu com nimu logs ID.

A CLI e os agentes

A CLI ainda não foi conectada

$ nimu status
nimu: a CLI ainda não foi conectada; no painel, em Publicar, clique em Conectar

A máquina está sem a chave da CLI. No painel, abra a vista Publicar e olhe o bloco CLI e agentes:

"Conectando a CLI…": a chave está a caminho. Espere alguns segundos e rode de novo.
"CLI desconectada.": clique em Conectar de novo.
"A CLI conecta quando a máquina ligar.": ligue a Sandbox.

O agente não consegue fazer isso sozinho: é a pessoa quem clica.

O token da CLI não vale mais

$ nimu status
nimu: Este token da CLI não vale mais: a CLI foi desconectada ou ganhou um token novo. No painel da Nimu, em Publicar, use Conectar de novo.

A chave que está na máquina deixou de valer. O caminho é o mesmo do problema anterior: no painel, em Publicar, veja o bloco CLI e agentes. Com Conectar de novo, a máquina recebe uma chave nova em alguns segundos.

O agente não acha as ferramentas nimu e navegador

O agente perdeu a configuração que vem na Sandbox. Rode no terminal:

$ nimu configurar-agentes

Cada linha da resposta diz o que mudou. Depois, feche e abra o agente, para ele carregar as ferramentas. O comando está em CLI nimu.

O comando ou a opção não existe

$ nimu voar
nimu: comando desconhecido: voar
veja: nimu ajuda

nimu ajuda lista os comandos, e nimu ajuda com o nome de um comando mostra o uso dele. Se o comando está nesta documentação e a sua CLI não tem, rode nimu atualizar.

A CLI não consegue falar com a Nimu

A mensagem começa com "não consegui falar com a Nimu" e termina com "Confira a internet da máquina e tente de novo." Outra forma é esta:

nimu: a Nimu está com problema agora (erro 502); tente de novo em instantes

Tente de novo em instantes. Se continuar, veja o status dos serviços.

O pedido do agente não está mais esperando

O painel diz "Este pedido não está mais pendente: foi confirmado, cancelado ou expirou (24 horas)."

O link de confirmação é de um pedido antigo. Peça ao agente para fazer o pedido de novo: ele devolve um link novo. O pedido de trocar ou remover segredos vale 2 horas, e os outros, 24.

Produção

O deploy não acha o Dockerfile

$ nimu deploy
nimu: não achei o Dockerfile em /home/dev/projetos/loja; rode nimu iniciar para criar um (ou rode o deploy na pasta do projeto)

Rode nimu iniciar na pasta do projeto, ou entre na pasta certa antes do deploy.

O deploy pergunta para qual app

$ nimu deploy
nimu: diga para qual app: --app ID (veja nimu apps) ou --novo para criar um, aberto a todos

O nimu.toml ainda não tem o id do app. Na primeira vez, use nimu deploy --novo. Para um app que já existe, nimu deploy --app ID.

O deploy recusa um arquivo com segredo

$ nimu deploy --novo
nimu: a construção levaria para a imagem arquivos com segredo: .env. Acrescente-os ao .dockerignore com **/ na frente (como **/.env e **/*.key, que valem em qualquer pasta; o nimu iniciar --sobrescrever escreve o da Nimu) e rode o deploy de novo; o segredo da produção vai com nimu segredo definir

Ponha o arquivo no .dockerignore e defina o valor com nimu segredo definir. Veja Segredos.

A construção da imagem falhou

A mensagem começa com "o docker build falhou", diz onde fica o registro inteiro e mostra o fim dele.

O erro é do Dockerfile ou do projeto. Leia as últimas linhas, corrija e rode o deploy de novo. O registro fica em ~/.local/state/nimu/deploy-ID.log.

Já há um deploy construindo

$ nimu deploy
nimu: já há um deploy construindo ou esperando a Nimu buscar a imagem nesta máquina; acompanhe com nimu versoes ID e tente de novo quando ele terminar

É uma construção por vez em cada Sandbox. A Nimu também sobe uma versão por conta de cada vez. Enquanto uma está a caminho, a seguinte recebe: "Já tem uma versão desta conta a caminho da produção. Espere ela terminar (nimu versoes mostra como está) e publique de novo."

A versão foi bloqueada

A versão 2 foi bloqueada pela checagem de segurança: tire o segredo do código (e troque a chave que vazou) e publique de novo.

A checagem achou um segredo dentro da imagem. A versão que estava no ar continua. nimu versoes ID --versao N lista os bloqueios, embaixo de "bloqueios (impedem a versão de subir):".

Tire o segredo do código, troque a chave no provedor, defina o valor novo com nimu segredo definir e publique de novo.

A versão falhou

A versão não respondeu no caminho de saúde em 60 segundos, ou a migração do banco falhou. A versão que estava no ar continua.

Rode nimu versoes ID --versao N. A resposta traz o erro e, embaixo de "últimas linhas do app (texto do app, não da Nimu):", o que o app escreveu antes de cair. Confira o que a produção exige do app:

Escutar em 0.0.0.0, na porta do nimu.toml.
Responder no caminho saude sem erro da faixa 500.
Ter, antes do deploy, os segredos de que ele precisa para subir.

Corrija e publique de novo. A lista inteira está em O que o app precisa.

A produção não está liberada, ou a máquina está cheia

nimu: A produção não está liberada para esta conta. Fale com a Nimu para liberar.

A cota de máquinas de produção da conta está em zero. Quem libera é a Nimu.

nimu: A máquina de produção leva até 3 apps e a sua conta já tem 3 nela (w4n8t3hd, b7wq3hzn, m4rk9t2q). A cota de apps da conta soma os da Sandbox e os da produção; para pôr o k7m2p9xq na produção, remova antes um dos que estão lá (nimu remover ID).

A máquina de produção leva até 3 apps. Remova um deles para pôr outro.

A imagem passou do tamanho

nimu: a imagem comprimida passou de 2 GiB, o máximo que a Nimu busca; deixe a imagem menor (.dockerignore, só as dependências de produção, uma imagem base menor)

Deixe de fora o que o app não usa para rodar: pastas de teste, dependências de desenvolvimento e arquivos grandes.

Não dá para apagar ou reiniciar a máquina de produção

"A máquina de produção ainda tem 1 app. Remova os apps da produção antes de apagar a máquina.": Apagar só vale com a máquina vazia. Remova os apps da produção antes.
"A máquina de produção está terminando outra ação. Tente de novo em instantes.": Ela faz uma ação de cada vez. Espere e repita.
"A máquina de produção não está ligada. Ela liga sozinha na próxima versão que o seu agente publicar.": Não há o que reiniciar agora.
"A sua conta não tem máquina de produção.": Ela é criada na primeira versão publicada, no primeiro segredo ou no primeiro banco.

Os logs não vieram

O comando responde "Os logs ainda não chegaram da produção; peça de novo em alguns segundos." ou "O app não escreveu nada ainda."

A primeira chamada pede os logs à produção. Rode nimu logs ID de novo em alguns segundos.

Segredos e banco

O nome do segredo é recusado

$ nimu segredo definir w4n8t3hd VITE_API_KEY
nimu: VITE_API_KEY começa com VITE_: variáveis assim vão para o código do navegador, e quem abre o app lê; use um nome sem VITE_ e leia o valor só no servidor

Vale também para NEXT_PUBLIC_, REACT_APP_ e os outros prefixos que vão para o navegador. Use outro nome e leia o valor só no servidor.

O valor foi escrito no comando

nimu: o valor não vai como argumento (fica no histórico do terminal e na lista de processos); mande pela entrada: printf %s "$VALOR" | nimu segredo definir ID NOME, ou rode sem o valor e digite quando pedir

Rode nimu segredo definir ID NOME sem o valor: ele é pedido em seguida, sem aparecer na tela.

O valor tem mais de uma linha

nimu: o valor tem quebra de linha, e a produção guarda cada segredo numa linha só; para um valor de várias linhas (uma chave PEM, o JSON de uma conta de serviço), guarde em base64 numa linha só, como: base64 -w0 chave.pem | nimu segredo definir ID NOME, e decodifique no app ao subir

O segredo DATABASE_URL é recusado

A resposta é "DATABASE_URL é gerenciado pela Nimu enquanto o app tem banco: ela cria e guarda o valor. Para usar outro banco, apague o da Nimu antes (nimu banco apagar)."

Enquanto o app tem banco na Nimu, esse nome é reservado. O app já recebe a variável sozinho.

O deploy é recusado porque o banco está cheio

A resposta é "Os bancos desta conta já ocupam 1 GB, o limite do teste grátis. Libere espaço no banco (ou apague um banco que não usa) e publique de novo."

O app segue no ar com a versão de agora. Apague dados, ou um banco que não usa mais, e publique de novo. nimu banco ID mostra quanto a conta usa.

Já tem uma ação no banco

A resposta é "Já tem uma ação no banco desta conta a caminho da produção (criar, restaurar ou apagar). Espere ela terminar (nimu banco mostra como está) e tente de novo."

É uma ação de banco por vez em cada conta. Acompanhe com nimu banco ID.

O id da cópia é recusado

nimu: o id da cópia tem letras minúsculas, números e -, como 20261005-0300-diaria (veja as cópias com nimu banco ID)

Copie o id da lista que o nimu banco ID mostra.

O nimu banco dev diz que a porta 5432 está ocupada

A mensagem é "a porta 5432 desta máquina já está ocupada por outro programa (outro Postgres?): pare-o, ou use esse Postgres direto no .env".

Outro banco já usa a porta na Sandbox. Pare esse programa, ou aponte o DATABASE_URL do .env para ele.

Navegador do agente

O navegador está desligado

$ nimu navegador abas
nimu: o navegador está desligado; ligue com nimu navegador ligar

Rode nimu navegador ligar. Pela ferramenta navegador, o agente liga o navegador sozinho ao abrir.

O agente não contorna login, código de verificação nem captcha. Ele pede a você: "abra Ver o navegador no painel, faça o login e me avise".

No painel, na vista Máquina, clique em Assumir o controle, faça o login e avise o agente. Ele continua na mesma aba. Veja Sandbox.

Pedidos demais

Quem faz pedidos demais em pouco tempo recebe uma destas frases. Em JSON, o motivo é muitos_pedidos.

Mensagem	O limite	O que fazer
"Muitas mudanças nos apps em pouco tempo. Espere alguns minutos e tente de novo."	30 por hora por conta, entre publicar, mudar e remover.	Espere alguns minutos.
"Muitos pedidos para a produção em pouco tempo. Espere alguns minutos e tente de novo."	30 por hora por conta, entre publicar versão, voltar, segredos, banco, reiniciar e apagar a máquina.	Espere alguns minutos. Junte as mudanças num deploy só.
"Muitos pedidos da CLI em pouco tempo. Espere um minuto e tente de novo."	120 por minuto para a chave de cada máquina.	Espere um minuto. Ao acompanhar uma versão, pergunte a cada 10 segundos.
"Muitas tentativas seguidas. Tente de novo mais tarde."	É a frase do painel para qualquer um desses limites.	Espere alguns minutos.

Não achou o seu problema

Veja o status dos serviços.
Rode o comando com --json: o campo motivo diz a causa, e a lista está em Motivos de erro no JSON.
Confira os números em Limites do teste.
No painel, abra um chamado em Suporte: a resposta chega lá e no seu e-mail.

Nesta documentação: CLI nimu, MCP para agentes e Limites do teste.