Com conta criada, o primeiro passo técnico é ligar a VPS ao painel através do agente Veloz.
1. Adicionar servidor
- Vá a Servidores → Adicionar servidor
- Dê um nome (ex.: «Produção» ou «Servidor-1»)
- Guarde — o painel gera uma chave de agente única
2. Instalar o agente na VPS
- Abra o servidor recém-criado
- Se o agente estiver offline, verá o wizard de registo com o comando de instalação
- SSH na VPS como root (ou sudo) e cole o script fornecido
- Aguarde ~1–2 minutos — o agente reporta heartbeat ao control plane
3. Confirmar estado online
Na Visão geral do servidor:
- Estado online (verde)
- Versão do agente visível (recomendado v1.7+ para deploy e proxies)
- Checklist a avançar (Docker, primeiro site, etc.)
Docker (opcional mas recomendado)
Para deploy de sites e marketplace, instale Docker pelo painel (banner «Instalar Docker» na overview) ou manualmente na VPS. Sem Docker, algumas funções ficam limitadas.
Problemas comuns
| Sintoma | O que verificar | |---------|-----------------| | Agente offline | Script correu até ao fim? Firewall bloqueia saída HTTPS? | | Chave inválida | Rotacionou a chave no painel sem reinstalar? | | Versão antiga | Use «Actualizar agente» na overview |
Próxima lição
Com agente online, passamos a publicar o primeiro site (Lição 3).