Instalar em outra máquina

hinow-cli deploy: o HiNow Code se instala num servidor pelo SSH, entra na sua conta sem senha e fica online. E o agente deploy.

Updated on Sep 16, 2026

Depois que o HiNow Code está numa máquina sua, ele consegue se instalar nas outras. hinow-cli deploy faz, pelo SSH, o que você faria à mão num servidor novo: instala o programa, entra na sua conta, deixa o servidor como serviço com atualização automática e confirma que a máquina apareceu online no HINOW Connect. E você não digita a senha em lugar nenhum.

hinow-cli deploy root@meu-servidor
hinow-cli deploy deploy@10.0.0.5 --name "Servidor da loja" --port 4096
hinow-cli deploy app@host:2222 --ssh -i --ssh ~/.ssh/loja

Só precisa de duas coisas: esta máquina logada (hinow-cli status) e acesso por chave SSH ao destino (ssh user@host true sem pedir senha; se pedir, ssh-copy-id user@host resolve).

O que acontece

1
Sonda a máquina
Sistema, arquitetura, usuário, curl ou wget, systemd ou launchd, e se já existe uma instalação.
2
Instala
Roda o instalador público lá (curl -fsSL https://hinow.ai/install.sh | bash, ou wget na falta do curl). O programa fica em ~/.hinow/bin.
3
Entra na sua conta, sem senha
Esta máquina aprova no backend um código de dispositivo com a própria sessão; a máquina nova recebe pelo canal SSH uma sessão só dela e a guarda cifrada com a identidade dela. Nenhuma senha viaja, nenhum arquivo é copiado, nenhum token aparece na tela.
4
Instala o serviço
hinow-cli service install --policy allow --autoupdate: sobe com a máquina, volta se cair, atualiza sozinho quando ocioso. Como root vira serviço do sistema; como usuário comum, serviço do usuário com enable-linger.
5
Confirma
Lê o nome e o id do dispositivo e espera até 60 s por ele online no hub. No fim mostra a linha para usar: hinow-cli run --machine "<nome>" ….

Opções

Opção	O que faz
`--name "…"`	Nome da máquina no hub (padrão: `HiNow Code · <hostname>`)
`--policy allow\|ask\|deny`	O que ela faz quando um dispositivo seu inicia uma sessão lá (padrão `allow`; um servidor sem tela não tem quem responder a `ask`)
`--port <n>`	Porta da API local lá
`--organization`, `--project`	Organização e projeto da sessão nova (padrão: os desta máquina)
`--no-service`	Só instala e entra na conta; você sobe o `serve` do seu jeito
`--ssh <opção>`	Opções extras do ssh, uma por `--ssh`, na ordem: `--ssh -J --ssh bastiao`
`--steps install,login,service,verify`	Repete só algumas etapas. Quando uma falha, a mensagem diz qual e sugere exatamente este comando

Quando algo falha

Etapa	Causa comum	O que fazer
`probe`	Sem chave SSH lá; porta ou jump host diferentes; destino Windows	`ssh-copy-id`; `--ssh -p --ssh 2222`; no Windows, o caminho manual abaixo
`install`	Sem `curl` nem `wget`; Alpine sem `bash`; proxy	`apt-get install -y curl`, `apk add curl bash`; `HTTPS_PROXY` no ambiente
`login`	Esta máquina não está logada; mais de uma organização ou projeto	`hinow-cli login` aqui; `--organization` e `--project`
`service`	Sem systemd (container, imagem mínima); porta ocupada	Rode `hinow-cli serve --policy allow --autoupdate` sob o init que houver, ou `@reboot` no cron; `--port`
`verify`	Saída 443 para `connect.hinow.ai` bloqueada; relógio errado	Lá: `hinow-cli connect status` e `~/.local/share/hinow/hinow/connect.log`

Peça em vez de digitar

Existe um agente só para isso. Na interface, escreva algo como "instale o HiNow no servidor root@10.0.0.5 e chame de Loja" ou "@deploy coloque o servidor de homologação online". O agente deploy roda o hinow-cli deploy, lê o resultado e, se uma etapa falhar, diagnostica e corrige o que dá para corrigir pelo SSH (instalar o curl, trocar a porta, ligar o enable-linger), sem nunca pedir nem mostrar senhas e tokens. Ele traz um runbook, a skill deploy-hinow, com o que fazer em Linux, macOS, Windows, containers e máquinas sem root.

À mão (Windows, container, sem SSH)

curl -fsSL https://hinow.ai/install.sh | bash     # Windows: irm https://hinow.ai/install.ps1 | iex
hinow-cli login                                   # e-mail, senha e o código 2FA, se houver
hinow-cli service install --policy allow --autoupdate
hinow-cli connect status

Num container, instale dentro dele e rode hinow-cli serve --policy allow --autoupdate como comando principal ou sob o supervisor que houver; containers raramente têm systemd.

Depois

A máquina nova aparece em hinow-cli connect devices, no chip This machine ▾ da interface e na aba remota do chat.hinow.ai. Para renomear, lá: hinow-cli connect name "Servidor da loja" e hinow-cli service restart. A sessão dela é separada da sua: dá para desconectá-la pelo chat ou com hinow-cli logout lá, sem mexer nas outras. Para remover tudo: hinow-cli service uninstall && hinow-cli uninstall.

O que a política allow significa

Com allow, qualquer dispositivo da sua conta pode iniciar sessões nessa máquina sem perguntar. É o certo para um servidor seu; numa estação compartilhada, prefira ask e deixe a interface aberta lá.

Was this page helpful?