Instalar o Nants

Antes de começar

Linux ou WSL2 no Windows.
Docker com o Compose v2, funcionando sem sudo.
Git.

O macOS e o Windows fora do WSL ainda não são suportados.

Instalar

Terminal v0.1.0-rc.4pré-release

$ curl -fsSL https://nants.tmdevlab.com/install.sh | sh

O instalador baixa a última versão, confere o SHA-256 e grava o executável em ~/.local/bin/nants. Nada usa sudo.

Conferir

$ nants doctor

Mostra OK ou FALHA para o Docker, o Compose, o Git, a porta e o espaço em disco, com o que fazer em cada caso.

Abrir

$ nants

O Nants abre no navegador. Se não abrir, use o endereço que aparece no terminal.

Usar pelo celular

Por padrão, o Nants abre só no seu computador. Para abrir no celular ou em outro aparelho da mesma rede, use Configurações > Acesso pela rede. A tela guia em passos e confere cada um.

WSL, modo NAT: Ligue Acesso pela rede local e reinicie o Nants. Rode uma vez o Script para ligar no Windows, no PowerShell como administrador; ele vale para qualquer tipo de rede. Se o Windows reiniciar, rode de novo. Depois, adicione os aparelhos.
WSL, modo espelhado: Os mesmos passos. Aqui o script só cria a regra de firewall do Windows.
Linux: Ligue, reinicie e adicione os aparelhos. Se houver firewall, libere a porta do Nants e as das prévias dos apps.

A opção fica salva e vale a partir do próximo início: Ctrl+C no terminal e nants de novo. Em modo rede, o terminal mostra o link de entrada deste computador, de uso único e válido por 10 minutos.

Para adicionar um aparelho, clique em Adicionar dispositivo. No outro aparelho, abra o endereço ou leia o QR code e digite o código de 6 dígitos, que muda a cada 60 segundos. Na lista de dispositivos autorizados, você renomeia ou revoga cada um.

Para desligar, desligue na mesma tela e, no WSL, rode o Script para desfazer no Windows. Para ligar só uma vez, sem salvar:

$ nants --lan

Só aparelhos que você adicionar abrem o Nants. As portas das prévias mostram o app gerado, não o Nants. Na rede local, o tráfego é HTTP, sem criptografia: para o máximo de segurança, use numa rede de confiança.

Problemas comuns

nants: comando não encontrado

A pasta ~/.local/bin não está no PATH. Inclua a linha abaixo no ~/.bashrc e abra o terminal de novo.

$ echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

O Docker pede permissão

Coloque o seu usuário no grupo docker e entre de novo na sessão. No WSL com o Docker Desktop, ligue a integração com a sua distribuição em Settings, Resources, WSL integration.

$ sudo usermod -aG docker $USER

A porta está ocupada

O Nants tenta as portas seguintes sozinho e mostra qual escolheu. Para usar uma porta fixa:

$ nants --port 3100

A página não abre no navegador do Windows

Um redirecionamento antigo do Windows, feito para o acesso pela rede, ocupa a porta do Nants. O Nants percebe, abre na próxima porta livre e explica no terminal.

Para desfazer, rode o Script para desfazer no Windows em Configurações > Acesso pela rede. Ou ligue o acesso pela rede local, se quiser mantê-lo.

O link de entrada expirou

O link do terminal vale uma vez e por 10 minutos. Reinicie o Nants para ter outro, ou adicione este navegador com um código mostrado num aparelho já autorizado.

Não abriu no outro aparelho?

As causas comuns: o aparelho está em outra rede ou na rede de visitantes; o roteador isola os aparelhos entre si; o passo 2 está pendente (no WSL, o IP pode ter mudado depois de reiniciar o Windows); o endereço foi digitado errado, então prefira o QR code.

Se a página de entrada abrir no aparelho, a rede está certa.

O primeiro teste no navegador demora

Na primeira vez, o Docker baixa a imagem do Playwright, de cerca de 2 GB. Depois fica guardada.

Atualizar

Rode o mesmo comando de instalação. Ele troca o executável e mantém configurações, dados e projetos.

Desinstalar

$ nants uninstall

Remove o executável e mantém configurações e dados. Para apagar também configurações e dados, use nants uninstall --purge, que pede confirmação.

Os seus projetos em ~/NantsProjects e os containers deles nunca são apagados.