Publicar uma porta da Sandbox

Publicar dá ao app que roda numa porta da Sandbox um endereço com HTTPS, como https://k7m2p9xq.nimucloud.app, em segundos. Serve para testar e mostrar. O app continua rodando na Sandbox: para ficar no ar sozinho, o caminho é a produção.

Atualizado em 9 de outubro de 2026

Três jeitos de publicar

Pedindo ao agente: Com o app rodando, peça: "publique a porta 3000". O agente confere a porta, pergunta se o app fica aberto a todos ou com senha e publica.
No terminal: Rode nimu porta 3000 e depois nimu publicar --porta 3000.
No painel: Na vista Publicar, preencha Publicar uma porta e clique em Publicar.

Os três fazem a mesma coisa e seguem as mesmas regras. Publicar é da Sandbox e exige os dados do titular completos.

Conferir a porta

A Nimu só chega no app que escuta em 0.0.0.0. O erro mais comum é o servidor de desenvolvimento preso em localhost: ele funciona no terminal, e o endereço publicado mostra fora do ar. Confira antes:

$ nimu porta 3000
A porta 3000 está pronta: o node escuta em 0.0.0.0, e a borda da Nimu chega nele.

Quando a porta não está pronta, a resposta diz o que fazer:

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

Como cada servidor passa a escutar em 0.0.0.0

Servidor	O que mudar
Vite	`npm run dev -- --host 0.0.0.0`, ou `server.host: true` no vite.config. Ponha também `'.nimucloud.app'` em `server.allowedHosts`.
Next.js	`next dev -H 0.0.0.0` ou `next start -H 0.0.0.0`
Astro	`astro dev --host 0.0.0.0`. Ponha também `'.nimucloud.app'` em `vite.server.allowedHosts`.
Nuxt	`nuxi dev --host 0.0.0.0`
Node	`server.listen(3000, '0.0.0.0')`
uvicorn	Acrescente `--host 0.0.0.0`.
Flask	`flask run --host 0.0.0.0`
Django	`python manage.py runserver 0.0.0.0:8000`
Rails	`rails server -b 0.0.0.0`
Python	`python3 -m http.server 8000 --bind 0.0.0.0`

Para ver o app antes de abrir para alguém, use https://ana-7k2p.nimucloud.com/proxy/3000/, com o nome da sua máquina. Só você abre esse endereço.

Publicar

$ nimu publicar --porta 3000
Publicado em https://k7m2p9xq.nimucloud.app (porta 3000, aberto a todos). O endereço começa a responder em alguns segundos.

As 8 letras do começo do endereço são sorteadas pela Nimu. Elas são o id do app: é com esse id que os outros comandos sabem de qual app você fala. O id nunca é reaproveitado.

Se a porta não estiver pronta, o nimu publicar publica assim mesmo e avisa, com uma linha que começa por "Atenção:". O endereço mostra fora do ar até o app escutar em 0.0.0.0.

Com --rotulo, o app ganha um nome de até 40 caracteres para você reconhecer no painel. O nome não muda o endereço.

Aberto ou com senha

Sem senha, qualquer pessoa na internet abre o endereço. Com senha, a Nimu pede a senha antes de mostrar o app. A senha tem de 8 a 72 caracteres.

$ nimu publicar --porta 4000 --gerar-senha
Publicado em https://m4rk9t2q.nimucloud.app (porta 4000, com senha). O endereço começa a responder em alguns segundos.
Senha: Xq7mK2pR9tWv4nHd  (guarde agora: ela não aparece de novo)

--gerar-senha: Sorteia uma senha de 16 letras e mostra uma vez só.
--senha-stdin: Pede a senha sem mostrar na tela, e ela não fica no histórico do terminal.
--senha S: Recebe a senha na linha de comando. Ela fica no histórico do terminal.

No painel, a escolha é entre Público e Com senha.

Ver e mudar um app

nimu apps lista os apps da conta, e nimu app ID mostra um deles. Com opções, o nimu app muda o app. O endereço não muda.

$ nimu apps
Apps publicados (2 de 3):
  k7m2p9xq  porta 3000  aberto a todos  no ar  https://k7m2p9xq.nimucloud.app
  w4n8t3hd  na produção  aberto a todos  no ar  https://w4n8t3hd.nimucloud.app  "loja"
$ nimu app k7m2p9xq --porta 8000
Pronto: https://k7m2p9xq.nimucloud.app (porta 8000, aberto a todos).

--porta N: Troca a porta. Vale na hora.
--gerar-senha: Põe senha num app aberto ou troca a senha. Vale na hora. --senha e --senha-stdin também servem.
--aberto: Tira a senha. Pela CLI, espera a sua confirmação no painel.
--rotulo T: Troca o nome no painel. --rotulo "" tira o nome.

Na lista, cada app tem uma situação: no ar, máquina desligada, conta suspensa, tirado do ar pela Nimu ou esperando a primeira versão, que é o app de produção antes de a primeira versão entrar no ar.

Remover um app

Remover tira o app do ar de vez. O endereço não volta: se você publicar a mesma porta de novo, ela ganha um endereço novo.

$ nimu remover k7m2p9xq --sim
Pedido enviado: confirme no painel em https://nimucloud.com/painel/#/confirmar/1. O app continua no ar até a confirmação.

Pela CLI e pelos agentes, a remoção não acontece na hora: ela vira um pedido que só você confirma, em Seu agente pediu. O pedido vale por 24 horas. Tirar a senha de um app funciona do mesmo jeito.

No painel, o botão Remover pergunta antes e remove na hora. O que roda na Sandbox continua rodando: só o endereço sai.

Quando o endereço mostra fora do ar

O app publicado roda na Sandbox. Quem abre o endereço vê a página "App fora do ar no momento" quando:

o processo do app parou;
o app escuta só em localhost;
a Sandbox está desligada.

Deixe o app rodando fora do terminal que você vai fechar, numa sessão do tmux ou com docker compose up -d. E confira com nimu porta.

A CLI conectada

O nimu age na sua conta com uma chave que a Nimu grava na própria máquina, no arquivo /etc/nimu/cli.json. A chave chega sozinha, alguns segundos depois que a Sandbox liga.

No painel, em Publicar, o bloco CLI e agentes mostra "CLI conectada." e tem dois botões:

Conectar de novo: A máquina recebe uma chave nova, e a de antes deixa de valer. É o que resolve o erro "a CLI ainda não foi conectada".
Desconectar a CLI: Os agentes deixam de publicar e de mudar apps pelo nimu. Os apps que já estão no ar continuam no ar.

A chave só funciona de dentro da sua máquina na Nimu. O agente é instruído a não ler nem mostrar o /etc/nimu/cli.json.

Limites e regras

Apps: No teste, até 3 por conta, somando os da Sandbox e os da produção. nimu status diz quantos de quantos.
Portas: De 1024 a 65535, menos as que a máquina usa: 8080 (o editor), 9119, 9120, 9121 e 9200.
Senha: De 8 a 72 caracteres. Quem erra demais espera: são 20 tentativas por visitante a cada 15 minutos.
Envios: O endereço aceita envios de até 100 MB por pedido.
Mudanças: Até 30 por hora por conta, entre publicar, mudar e remover.

Você responde pelo que o app mostra e coleta. Leia as regras dos apps publicados. Viu um app da Nimu sendo usado para golpe? Denuncie em nimucloud.com/denunciar.

No site: Publicar. Nesta documentação: todos os comandos em CLI nimu e os erros em Problemas comuns.