Passo a passo no servidor Linux

1. Enviar a pasta

Os scripts ficam em /opt/sentinel-runtime/scripts/ e os compose na raiz /opt/sentinel-runtime/.

rsync -avz -e "ssh -i ~/chave.pem" \
  ./sentinel-vigilark-implantacao/ \
  usuario@IP:/opt/sentinel-runtime/

2. Instalar

Como root. O script instala o Docker se faltar, cria o .env na primeira vez, faz pull das três imagens, sobe a stack e habilita o serviço no boot.

sudo LICENSE_API_URL='https://URL-DO-SERVIDOR-DE-LICENCAS' \
  ADMIN_PASSWORD='SenhaInicialForte' \
  IMAGE_TAG=latest \
  bash /opt/sentinel-runtime/scripts/install-ec2.sh --yes

Anote a senha se não passar ADMIN_PASSWORD. Ela também fica em /opt/sentinel-runtime/.env.

3. Arquivo .env

Salve como /opt/sentinel-runtime/.env. Não mude SECRET_KEY depois de cadastrar credencial na interface.

APP_ENV=production
DEBUG=false
DOCKERHUB_USER=eulerazzevedo
IMAGE_TAG=latest
LOCAL_IMAGES=false
DATABASE_URL=postgresql+asyncpg://sentinel:sentinel@postgres:5432/sentinel
API_KEY=
SECRET_KEY=
ADMIN_PASSWORD=
LICENSE_API_URL=https://URL-DO-SERVIDOR-DE-LICENCAS
MONITORING_INTERNAL_URL=http://monitoring:8000
LICENSE_GUARD=true
SENTINEL_DEMO=false
SENTINEL_LOCAL_FEATURES=false
CORS_ORIGINS=["https://seu-dominio"]
HEAVY_SCAN_MAX=1
ZAP_HEAP=2048m

4. Primeiro acesso

Abra http://IP:5173, entre com a senha e cole o serial em Ativar licença. Sem serial ativo, a API responde 403. O heartbeat da licença é de cerca de 24 h.

Não abra as portas 8000, 8888 nem 5432. Monitoring, security e o banco escutam só em 127.0.0.1. Com nginx na frente, publique a 443 e deixe 5173 em localhost.

5. Operação

Dentro de /opt/sentinel-runtime. Nunca use docker compose down -v — isso apaga o Postgres e o histórico de pentest.

sudo bash scripts/update-client.sh
sudo bash scripts/start-client-stack.sh
sudo bash scripts/stop-client-stack.sh
sudo bash scripts/set-client-password.sh 'nova'

Pedir licença

O serial não vem na imagem. Fale comigo por e-mail, LinkedIn ou Google Agenda.