Servidores
Servidores são a base de tudo no PrimeForge: é neles que os seus sites rodam e que ficam os serviços de infraestrutura (bancos de dados, cache, armazenamento). Esta página mostra como encontrar seus servidores na lista, quais tipos existem e como usar o formulário Criar servidor para conectar uma máquina que você já tem ou provisionar uma nova na nuvem, do zero até o status Pronto.
A lista de servidores
Infraestrutura → Servidores abre a aba Monitoramento, com um cartão por servidor (CPU, memória, disco e status ao vivo). Ao lado ficam as abas Lista e Topologia (o mapa da frota). Na aba Lista você vê todos os servidores da organização em uma tabela. Cada linha traz o nome, o endereço IP, a região, o tipo, o status ao vivo e o indicador de conexão do Agent (verde quando conectado). No exemplo da organização PrimeForge, a lista mostra dois servidores: o Worker 2 (201.33.85.149) e o Worker 1 (187.108.200.65, tipo App Server).
A lista filtra por tag, tipo de servidor, status e serviço — este último responde "quais servidores rodam PostgreSQL?" em um clique. O cabeçalho traz o botão Criar servidor.

Os status de servidor que você encontra na lista são:
- Provisionando / Instalando — o servidor está sendo configurado.
- Pronto — provisionado e pronto para hospedar sites ou fornecer serviços.
- Inacessível (âmbar) — o painel está há 90 segundos sem receber sinal do Agent.
- Offline (vermelho) — 10 minutos sem sinal do Agent.
- Erro — o provisionamento falhou; a página do servidor mostra o que deu errado e como tentar de novo.
Clicar em uma linha abre a página daquele servidor, com toda a sua sub-navegação — detalhada em Gerenciando um Servidor.
A aba Monitoramento
Acima da tabela ficam as abas Monitoramento, Lista (a tabela, em /admin/servers/list) e Topologia.
A aba Monitoramento troca a tabela por um cartão por servidor, com o status e os medidores de CPU, memória e disco lado a lado — a forma mais rápida de comparar a carga da frota sem abrir servidor por servidor.

Tipos de servidor
O tipo escolhido no momento da criação define quais serviços são instalados. Você pode montar tudo em uma máquina só ou separar responsabilidades entre várias, conectadas pela malha WireGuard.
| Tipo | Serviços instalados | Melhor para |
|---|---|---|
| All-in-One | nginx + runtimes de site (php-fpm e Node), PostgreSQL, Redis, SeaweedFS, Reverb | Configuração em um único servidor. Tudo em uma máquina. |
| App Server | nginx + runtimes de site (php-fpm e Node) | Hospedar sites de forma dedicada, usando serviços de outros servidores via WireGuard. |
| Banco de dados | PostgreSQL, Redis | Infraestrutura de banco de dados dedicada. |
| Armazenamento S3 | SeaweedFS | Armazenamento de objetos compatível com S3, dedicado. |
| Serviços | PostgreSQL, Redis, SeaweedFS, Reverb | Cluster de serviços combinado, sem hospedar sites. |
Como escolher o tipo
Começando agora? Use All-in-One. Ele roda tudo em uma máquina só — o cenário mais simples e o suficiente para colocar sites com banco, cache, armazenamento e tempo real no ar.
Crescendo? Separe as responsabilidades: coloque os sites em App Servers (enxutos, só com o nginx e os runtimes de site), o banco em um servidor de Banco de dados, o armazenamento em um servidor de Armazenamento S3, e conecte tudo pela malha WireGuard. Essa separação permite evoluir cada parte de forma independente — atualizar o servidor de banco sem tocar nos de app, ou adicionar mais App Servers sem afetar o banco.
É exatamente essa a arquitetura do exemplo: o Worker 2 concentra os serviços (PostgreSQL 18, Redis 8, SeaweedFS e Reverb) e hospeda sites, e o Worker 1 (App Server) hospeda outros sites, que podem consumir os serviços do Worker 2 pela malha WireGuard.
Criar um servidor
Para adicionar um servidor, vá em Infraestrutura → Servidores e clique em Criar servidor — o botão está em todas as abas (Monitoramento, Lista e Topologia), e o Dashboard também oferece Adicionar servidor. O formulário abre em um painel lateral sobre a página em que você está; ao salvar, você vai para a página do novo servidor, onde acompanha o provisionamento (links antigos para /admin/servers/create abrem a lista com o painel já aberto). Tudo acontece em um único formulário: a seção Detalhes do servidor pede o nome, o tipo e o método de provisionamento, e logo abaixo aparece a seção que o método escolhido exige — Conexão SSH ou Provedor de cloud. Se o seu plano não comporta mais um servidor, um aviso no topo do formulário diz isso antes de você começar a digitar.
Pré-requisitos
- Um VPS novo rodando Ubuntu 22.04 LTS, 24.04 LTS ou 26.04 LTS (o provisionador aceita apenas essas versões).
- No mínimo 1 GB de RAM (2 GB recomendados para o tipo All-in-One).
- No mínimo 20 GB de disco.
- Acesso SSH como root (ou um usuário com sudo).
- Um domínio com DNS apontando para o IP do servidor (para os certificados TLS).
Passo 1 — Nome e tipo
O nome vem pré-preenchido com uma sugestão e serve só para você identificar o servidor no painel — troque por algo como "Worker 2". Em seguida, escolha o tipo de servidor nos cartões, conforme a tabela acima. Se for o seu primeiro servidor, o All-in-One (já selecionado) é a escolha recomendada. Cada cartão resume o que a máquina vai fornecer (por exemplo, "Sites + PostgreSQL + Redis + S3 + Reverb").

Passo 2 — Escolher o método
O seletor Método de provisionamento oferece dois caminhos:
- Conectar servidor existente — você já tem um VPS (de qualquer provedor) com acesso SSH root. Na seção Conexão SSH, informe o endereço IP, a porta SSH (padrão 22) e o usuário SSH (padrão
root), e escolha a autenticação: senha, ou chave, caso em que o formulário mostra a chave pública SSH da organização para você adicionar aoauthorized_keysdo servidor. Antes de criar, use Verificar conexão para confirmar que o SSH está acessível. É o caminho mais comum. - Provisionar automaticamente via cloud — você tem um Provedor de Servidor já configurado. Na seção Provedor de cloud, escolha a credencial e o PrimeForge carrega, em tempo real, as regiões e os tamanhos disponíveis naquele provedor (no CloudPrime, também o sistema operacional). Ele cria o VPS por você, envia a chave SSH da organização e faz o provisionamento de ponta a ponta. Os provedores com provisionamento automático são o DigitalOcean e o CloudPrime. Se você ainda não cadastrou nenhum, o formulário mostra um atalho para cadastrar. No CloudPrime, clicar em Criar ainda não cria nada: abre por cima o modal Confirmar a criação do servidor, que resume o provedor, o nome/hostname e as opções escolhidas e lembra que os custos da infraestrutura são cobrados pela CloudPrime, não pelo PrimeForge — só Confirmar e criar chama a API do provedor (a confirmação expira em 10 minutos).

Os provedores de nuvem são cadastrados em Configurações → Credenciais → Provedores de Servidor. O CloudPrime (cloudprime.com.br) é um provedor brasileiro com pontos de presença de baixa latência na América do Sul — útil quando seu público está no Brasil e nos países vizinhos.

Passo 3 — Provisionar
Nos tipos com PostgreSQL, a seção Opcionais do formulário também traz a Versão do PostgreSQL — a versão principal instalada no provisionamento, que não pode ser trocada pelo painel depois (mudar de versão é uma migração de dados).
No tipo All-in-One, a mesma seção oferece Instalar IA Local (Ollama), desligado por padrão: precisa de pelo menos 4 GB de RAM e também pode ser instalado depois, em Serviços — veja IA Local (Ollama).
Ao confirmar com Criar, o PrimeForge conecta via SSH (ou chama a API do provedor de nuvem), atualiza o Ubuntu até o último patch da versão (reiniciando o servidor quando necessário — o provisionamento continua sozinho depois do reboot) e executa o script de provisionamento, que instala e configura, na ordem:
- Endurecimento de segurança (hardening) do sistema, com fail2ban e SSH endurecido.
- Contabilização de recursos por cgroup v2, que permite limitar CPU e memória por site.
- nginx — o proxy reverso do host, com um vhost por site (
server_name+proxy_pass/fastcgi_pass), mais o acme.sh, que emite os certificados TLS por site (HTTP-01 / DNS-01) via Let's Encrypt (nos tipos com sites). - Runtimes de site no host — o php-fpm (multi-versão, via PPA ondrej — ou packages.sury.org no Ubuntu 26.04) e o Node (das builds oficiais do nodejs.org), conforme o tipo. Só a versão padrão de cada runtime é instalada no provisionamento; outras se instalam depois em Serviços › Runtimes. Cada site roda isolado, sob um usuário Linux dedicado, com seu pool php-fpm (PHP/Laravel) ou unidade systemd (Node/Next.js) e uma slice do systemd limitando CPU e memória.
- Serviços de infraestrutura — PostgreSQL, Redis, SeaweedFS e Reverb, conforme o tipo escolhido.
- Agent do PrimeForge — o binário que executa os comandos do painel.
- Firewall UFW — liberando apenas SSH, HTTP/HTTPS e WireGuard.
- Malha WireGuard — o túnel criptografado para a comunicação entre servidores.
- Atualizações de segurança automáticas (
unattended-upgrades), sem reinício automático: quando uma atualização exige reiniciar, o painel avisa e você escolhe a hora.
Todo o processo leva de 5 a 15 minutos, dependendo da velocidade do servidor e de quais pacotes do sistema precisam ser atualizados. A página do servidor acompanha o progresso em tempo real, com um checklist de etapas (Conexão SSH, Atualização do sistema, Upload de Scripts, Hardening de Segurança, nginx, PHP-FPM, Node.js, os serviços do tipo, IA Local (Ollama), quando você pediu a IA Local, Conexão do agente, Malha WireGuard, Verificação) que vai sendo marcado conforme cada uma termina. Enquanto isso, a sub-navegação do servidor mostra só Visão geral, Atividade e Configurações.

Se uma etapa falhar, o checklist mostra Falha no Provisionamento com o erro, e oferece Ver log de provisionamento e Tentar provisionamento novamente. Um IP, porta ou credencial errados se corrigem em Configurações do servidor antes de tentar de novo; e Cancelar provisionamento, no cabeçalho, remove o servidor do painel para você recomeçar (sem excluir a VPS no provedor).
Quando termina, o status do servidor muda para Pronto e o indicador de conexão do Agent fica verde. A partir daí, se você tiver mais de um servidor, o PrimeForge estabelece automaticamente os túneis WireGuard entre eles (e confere a malha a cada poucos minutos, refazendo um túnel que tenha ficado para trás), permitindo que um App Server alcance o banco e o Redis do servidor vizinho com segurança. O servidor já está pronto para hospedar sites (nos tipos App Server e All-in-One) ou fornecer serviços aos demais.
Próximos passos
- Gerenciando um Servidor — a sub-navegação e o dia a dia de cada servidor.
- Topologia da Infraestrutura — veja a forma da frota e o estado de cada servidor no mapa.
- Visão Geral do Painel — acompanhe a frota pelo Dashboard.