Do que o servidor precisa

Um servidor ou uma VM resolve: Ubuntu Server 26.04, 4 núcleos, 17 GiB de RAM, um segundo disco vazio e nenhuma porta de entrada. A instalação confere cada item desta página antes de mudar qualquer coisa, e mostra a correção de cada item que falhar. Instale o nó mostra como rodar só essas verificações, dias antes da instalação.

O servidor

• Um servidor só para o nó. O detachbox-node-host roda como root e executa os comandos que o servidor do detachbox assina, então o nó ocupa o servidor inteiro. Nada do mesmo tipo roda ao lado dele: nem Docker, nem LXD, nem um Incus ou cloudflared seus, nem outro pool ZFS. A verificação lista tudo o que encontrar, com o comando que remove cada coisa.
• Ubuntu Server 26.04 LTS em x86_64 (amd64), iniciado com systemd e cgroup v2, com o sistema de arquivos raiz em ext4 ou xfs, não em ZFS. Uma VM no seu hypervisor ou na sua conta de nuvem serve tão bem quanto hardware físico.
• 4 núcleos de CPU ou mais. Dois ficam com o sistema; todos os outros rodam os seus terminais.
• 17 GiB de RAM no mínimo absoluto; é a partir de 64 GiB que o nó compensa. 8 GiB ficam com o sistema e o build da imagem base. O cache do ZFS ocupa um dezesseis avos da RAM, arredondado para baixo até uma potência de dois, entre 1 e 16 GiB. Seus terminais recebem o resto, e a verificação mostra a divisão para o seu servidor.
• Secure Boot desligado, ou a chave DKMS registrada. O Ubuntu 26.04 vem com o ZFS 2.4.1, que perde blocos gravados com deduplicação, então o instalador compila o OpenZFS 2.4.4 e o módulo de kernel dele no servidor. Os headers do kernel em execução precisam estar no apt.
• Um relógio sincronizado (NTP, UDP 123). O nó só aceita requisições do servidor com até 60 segundos de diferença do próprio relógio.

O disco

O pool ZFS do nó precisa de um segundo disco, inteiro e vazio, de 100 GiB ou mais. 70% do pool vira o disco da sua conta. O resto guarda o disco de sistema de cada terminal, as imagens base e o espaço livre de que o ZFS precisa para continuar rápido. O pool usa compressão lz4, deduplicação e autotrim.

O instalador recusa um disco com tabela de partições, sistema de arquivos, rótulo de LVM, RAID ou ZFS, ou qualquer coisa montada. Ele nunca destrói dados e não tem opção para forçar. Se o que está no disco não importa, limpe você mesmo antes:

sudo wipefs -a /dev/sdb            # o disco que você dá ao pool
sudo zpool destroy <pool>          # antes, se o disco pertence a um pool ZFS

A rede

O nó não precisa de nenhuma porta de entrada. Toda conexão que ele faz é de saída:

O nó reconstrói a imagem base a cada 6 horas, então esses hosts continuam em uso depois da instalação.

Dê aos terminais a mesma saída para a internet que o notebook de um desenvolvedor tem: os agentes chamam os provedores de modelos, e os builds baixam dos registros de pacotes.

Libere esses hosts sem inspeção de TLS. O node-host e o cloudflared só aceitam certificados de autoridades públicas, e quando algo no meio do caminho reassina o tráfego, a verificação mostra a autoridade que recebeu.

Os navegadores dos seus engenheiros acessam o painel em my.detachbox.com e api.detachbox.com, e os endereços próprios do nó em detachbox.dev, listados em O que os terminais alcançam.

O token

A instalação usa um token de registro que o seu contato no detachbox fornece. Ele vale para um servidor e uma instalação. Um servidor tem 7 dias para se registrar com ele, e depois do registro o token aceita novas execuções dessa instalação por mais 7 dias. Um token novo substitui o anterior.