Instalação#

Requisitos#

Debian 13 (trixie) amd64, kernel 6.12 (padrão do Debian).
Placa de rede com XDP nativo para desempenho total (ex.: Intel ixgbe/i40e/ice, Mellanox mlx5). Sem XDP nativo o dataplane funciona em modo genérico, indicado só para testes.
Teste: 2 CPUs e 2 GB de RAM. Produção: CPUs rápidas no mesmo nó NUMA da placa e RAM proporcional à quantidade de sessões.
Acesso à internet para a licença (há tolerância de 72 h sem contato).

Instalação pela ISO (recomendada)#

A ISO do Portgrid é baseada no Debian 13, híbrida BIOS/UEFI, e já traz tudo instalado.

O menu tem modo live (para testar o hardware) e INSTALAR PORTGRID - APAGA O DISCO AUTOMATICAMENTE. Escolher a segunda opção é a confirmação: o primeiro disco interno é apagado e o servidor instalado sem perguntas.
O acesso é pelo usuário operador, com a CLI cgnatsh como shell. O root fica bloqueado.
No primeiro boot, a primeira interface física recebe 192.168.0.1/24.
O resumo do acesso fica em /root/primeiro-acesso.txt e a senha do serviço é única por instalação.
Para testar em máquina virtual, 2 CPUs, 2 GB de RAM, disco e uma placa de rede bastam.

Primeiro acesso#

De outra máquina em 192.168.0.0/24: ssh operador@192.168.0.1 (senha operador; o sistema exige a troca no primeiro login). A CLI oferece o assistente de primeiro acesso (comando setup): nome do servidor, interface e IP de gerência, gateway, DNS e chave de licença.

Próximos passos#

Defina as placas do dataplane (set cgnat dataplane nic-interfaces <placa>), veja variáveis de ambiente.
Ative a licença.
Crie o pool público e a política CGNAT.
Rode request system tuning apply e siga as configurações recomendadas.

Para instalação sobre um Debian 13 já existente, consulte o suporte.