Pular para conteúdo

Instalação

A instalação de referência é a mesma que a Aamora usa em produção: docker compose com o banco e o app, um proxy reverso no host e um certificado para cifrar as chaves de sessão.

1. Pasta e segredos

sudo mkdir -p /opt/nexus && cd /opt/nexus
# Senha do banco e senha do certificado de Data Protection: gere valores longos e guarde-os.
cat > .env <<EOF
POSTGRES_DB=Nexus
POSTGRES_USER=postgres
POSTGRES_PASSWORD=$(openssl rand -base64 32)
DP_CERT_PASSWORD=$(openssl rand -base64 32)
EOF
chmod 600 .env

2. Certificado de Data Protection

O Nexus cifra em repouso as chaves que assinam os cookies de login e os tokens de formulário. Sem um certificado, o app se recusa a subir em produção, de propósito.

source .env
openssl req -x509 -newkey rsa:2048 -days 3650 -subj "/CN=nexus-dataprotection" \
  -keyout dp.key -out dp.crt -nodes
openssl pkcs12 -export -out dataprotection.pfx -inkey dp.key -in dp.crt -passout "pass:$DP_CERT_PASSWORD"
rm dp.key dp.crt
chmod 600 dataprotection.pfx

Faça backup deste arquivo

Perder o dataprotection.pfx não perde dados, mas desloga todo mundo e invalida links de confirmação pendentes. Guarde-o junto com o .env.

3. docker-compose.yml

name: nexus
services:
  db:
    image: postgres:18-alpine
    restart: unless-stopped
    env_file: .env
    volumes:
      - pgdata:/var/lib/postgresql
    networks: [nexus]
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
      interval: 10s
      retries: 5

  web:
    image: nexus-web:${NEXUS_VERSION:?defina NEXUS_VERSION}
    restart: unless-stopped
    ports: ["127.0.0.1:5100:8080"]
    env_file: .env
    environment:
      ASPNETCORE_ENVIRONMENT: Production
      ConnectionStrings__DefaultConnection: "Host=db;Port=5432;Database=${POSTGRES_DB};Username=${POSTGRES_USER};Password=${POSTGRES_PASSWORD}"
      APPLY_MIGRATIONS_ON_STARTUP: "true"
      PUBLIC_BASE_URL: https://nexus.suaempresa.com.br
      AllowedHosts: "nexus.suaempresa.com.br;localhost"
      KNOWN_PROXIES: 172.30.0.1
      DataProtection__CertificatePath: /app/dp/dataprotection.pfx
      DataProtection__CertificatePassword: ${DP_CERT_PASSWORD}
      Smtp__Host: smtp.suaempresa.com.br
      Smtp__Port: "587"
      Smtp__UserName: nexus
      Smtp__Password: ${SMTP_PASSWORD}
      Smtp__SenderEmail: [email protected]
    volumes:
      - uploads:/app/App_Data/uploads
      - ./dataprotection.pfx:/app/dp/dataprotection.pfx:ro
    networks:
      nexus: { gw_priority: 1 }
    depends_on:
      db: { condition: service_healthy }

volumes:
  pgdata:
  uploads:

networks:
  nexus:
    ipam:
      config:
        - subnet: 172.30.0.0/24
          gateway: 172.30.0.1

KNOWN_PROXIES é o gateway da rede Docker: é dele que o app aceita o cabeçalho X-Forwarded-For do proxy. O app expõe só 127.0.0.1:5100; quem fala com a internet é o proxy.

4. Proxy reverso

Exemplo para Nginx. O importante é repassar o WebSocket (o Nexus usa uma conexão persistente por usuário) e informar o esquema https.

map $http_upgrade $connection_upgrade { default upgrade; '' close; }

server {
    listen 443 ssl;
    http2 on;
    server_name nexus.suaempresa.com.br;
    ssl_certificate     /etc/ssl/nexus/fullchain.pem;
    ssl_certificate_key /etc/ssl/nexus/privkey.pem;
    client_max_body_size 12m;

    location / {
        proxy_pass http://127.0.0.1:5100;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto https;
        proxy_read_timeout 1h;
    }
}

5. Subir

docker load < nexus-web-1.17.0.tar.gz        # a imagem que você recebeu
NEXUS_VERSION=1.17.0 docker compose up -d --wait
curl -s http://127.0.0.1:5100/health/ready   # Healthy

O app aplica as migrations do banco sozinho ao subir (APPLY_MIGRATIONS_ON_STARTUP). A primeira conta criada pela tela de registro é uma conta comum; crie o workspace e convide a equipe.

6. Conferir

  • https://nexus.suaempresa.com.br/version mostra a versão.
  • /health/live e /health/ready servem para o seu monitoramento, sem autenticação.
  • Mande um convite para si mesmo: se o e-mail chegar, o SMTP está certo.