Coloque no ar o app que o seu agente construiu

1. Uma vez só: no painel, em Publicar, clique em Conectar. A Sandbox recebe a chave que deixa o nimu agir na sua conta. Publicar também pede os dados do titular completos no painel.
2. Deixe o app rodando na máquina e peça ao agente: publique a porta 3000.
3. A porta se confere com nimu porta 3000. O app precisa escutar em 0.0.0.0, não só em localhost. No Vite, é --host 0.0.0.0. No Next.js, -H 0.0.0.0.
4. O agente é instruído a perguntar se o app fica aberto a todos ou com senha. Depois, publica com nimu publicar.

Sem agente, dá no mesmo: você roda os comandos no terminal do editor, ou publica a porta pelo painel, em Publicar.

Os comandos de todo dia

nimu status

A máquina, os apps publicados, a máquina de produção e a cota da conta.

nimu porta 3000

Confere se o app da porta está pronto para publicar.

nimu publicar --porta 3000

Publica a porta num endereço com HTTPS.

nimu apps

Os apps publicados, com a porta e quem abre.

nimu remover ID

Tira o app do ar de vez. Espera a sua confirmação no painel.

nimu ajuda

Todos os comandos. Cada um aceita --json, que é como os agentes leem a resposta.

1. Na pasta do projeto, nimu iniciar escreve o Dockerfile, o .dockerignore e o nimu.toml. Ele reconhece projetos Node.js, Vite, Next.js, Python e sites estáticos, e não troca um arquivo que já existe.
2. nimu deploy --novo constrói a imagem na Sandbox, cria o app de produção e publica a primeira versão. Nas próximas, é só nimu deploy.
3. A primeira versão da conta cria a máquina de produção, de 1 vCPU, 2 GB de memória e 10 GB de disco. Ela aparece no painel, em Produção.
4. A versão nova só assume depois de responder no caminho de saúde. Se não responder em 60 segundos, a que estava no ar continua.

$ nimu deploy --novo --esperar
App novo: https://k7m2p9xq.nimucloud.com.br (aberto a todos; fora do ar até a primeira versão ficar ativa; o id ficou no nimu.toml).
...
No ar: https://k7m2p9xq.nimucloud.com.br (versão 1).

O que o app precisa

• Escutar em 0.0.0.0, na porta que está no nimu.toml.
• Responder no caminho de saúde em até 60 segundos depois de subir.
• Rodar sem root.
• Não depender do arquivo .env nem de nada fora da imagem.

porta = 3000
saude = "/"
memoria_mb = 256

Segredos fora do código

Chaves de API e senhas entram com nimu segredo definir ID NOME. O valor é pedido sem aparecer na tela, sai cifrado da Sandbox e chega ao app como variável de ambiente. Um segredo novo vale em cerca de 1 minuto, sem publicar de novo.

O nimu deploy recusa construir a imagem que levaria um .env ou uma chave, e a checagem da produção bloqueia a versão em que acha um segredo. Nos logs, que saem com nimu logs ID, os valores aparecem escondidos.

O app dorme quando ninguém visita

Depois de 15 minutos sem nenhuma visita, o app dorme. A visita seguinte acorda o app e espera ele subir. O Postgres dorme e acorda junto.

banco = true
migrar = ["npx", "prisma", "migrate", "deploy"]

Como o app usa

Ele lê a variável DATABASE_URL, que a Nimu define sozinha na produção. Esse segredo não se define nem se remove à mão.

Migração

O comando de migrar roda antes de cada versão subir, depois de uma cópia do banco. Se a migração falhar, a versão nova não sobe e a antiga segue no ar.

Cópias

Na máquina de produção ficam as 7 diárias mais novas, feitas às 3h da manhã, as 3 feitas antes de cada publicação e a última feita antes de restaurar. Toda noite, uma cópia cifrada também vai para fora da máquina.

Restaurar

nimu banco ID lista as cópias. Restaurar uma delas espera a sua confirmação no painel. O app para por alguns segundos, e antes a Nimu guarda uma cópia do banco de agora, para desfazer.

Para desenvolver

nimu banco dev sobe um Postgres local na Sandbox e grava o DATABASE_URL dele no .env do projeto, que fica fora do git e da imagem.

O que ele não faz

O banco não aceita conexão de fora da máquina de produção: só o app chega nele. Não dá para ligar um cliente SQL do seu computador.

No teste grátis, os bancos da conta somam até 1 GB. Acima disso, o deploy é recusado até sobrar espaço, e o app segue no ar.

$ nimu voltar k7m2p9xq --versao 1
Pedido na fila: k7m2p9xq volta para a versão 1 em instantes (só a imagem; o banco fica como está, e a migração feita não é desfeita). Acompanhe com: nimu versoes k7m2p9xq

Quem volta

O agente, sem esperar confirmação. Ou você, no painel, em Produção, com o botão Voltar para esta versão.

O banco fica como está

Voltar a versão não desfaz a migração. Para o banco de antes, restaure a cópia feita antes daquele deploy.

Os segredos também

A versão anterior sobe com os segredos de agora.

O agente pede, você confirma

O que não tem volta fica esperando o seu clique no painel, na parte Seu agente pediu.

• Remover um app, ou tirar a senha de um app.
• Trocar ou remover um segredo que já existe.
• Restaurar uma cópia do banco, ou apagar o banco.

Até a confirmação, nada muda. O pedido vale por 24 horas, e o de segredos, por 2 horas.

Apps publicados

Até 3 por conta, somando os da Sandbox e os da produção.

Máquina de produção

Uma por conta, de 1 vCPU, 2 GB e 10 GB, com até 3 apps.

Memória de cada app

De 128 a 1024 MB na produção. O padrão é 256 MB.

Imagem do app

O arquivo da imagem, já comprimido, pode ter até 2 GB.

Banco de dados

Até 1 GB, somando os bancos da conta.

Conexão

Até 100 Mb/s em cada máquina.

Você responde pelo que o app mostra e coleta, e as regras do que não pode valem para os apps. Leia as regras dos apps publicados.