Installation

Instalar num Servidor Windows de LAN

Corre o QuoteNode com Docker Desktop num PC Windows dentro de uma rede de escritório.

Instalar num Servidor Windows de LAN

Usa este caminho quando um PC Windows no escritório deve hospedar o QuoteNode para utilizadores na mesma rede local.

Quando usar

A equipa comercial trabalha dentro de uma LAN de escritório.
Os clientes não precisam de abrir links de propostas a partir da internet pública.
Queres um beta interno sem gerir um VPS público.

O que não vai funcionar

Links públicos de propostas e de notificação funcionarão apenas para dispositivos na mesma LAN ou VPN. Clientes externos não conseguem abrir um endereço privado de LAN.
Mensagens de email podem ser enviadas se o SMTP estiver configurado, mas os links dentro delas ainda apontam para o URL da LAN.
Suspensão, reboots ou atualizações do Docker Desktop podem interromper o serviço.

Pré-requisitos

Docker Desktop com Compose v2 ativado.
Endereço IP de LAN estável ou reserva DHCP para o host Windows.
Pelo menos 2 GB de RAM disponíveis e 10 GB de espaço livre em disco.
Localização regular de backup fora do volume do Docker.

Verifica no PowerShell ou na Linha de comandos:

docker --version        # Should show 24.0+
docker compose version  # Should show v2.x

Passo 1 — Criar uma diretoria de projeto

mkdir quotenode
cd quotenode

Passo 2 — Criar o ficheiro de configuração

Cria um ficheiro chamado .env na diretoria de projeto. Substitui 192.168.1.50 pelo IP real do host Windows (ou um nome DNS interno como quotenode.local):

# Database
DB_URL=jdbc:postgresql://postgres:5432/quotenode
DB_USERNAME=quotenode
DB_PASSWORD=change-me-to-something-random-32-chars
DB_NAME=quotenode

# ============================================================
# SECURITY SECRETS — UNIQUE to this installation.
# SAVE THIS FILE and keep a secure backup.
# ============================================================
DB_ENCRYPTION_KEY=0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
TIMING_TOKEN_SECRET=change-me-timing-secret-min-32-chars
PUBLIC_LINK_PASSWORD_SESSION_SECRET=change-me-session-secret-min-32

# LAN URL — replace with your PC's IP or internal DNS name
CORS_ALLOWED_ORIGINS=http://192.168.1.50
DOMAIN=192.168.1.50

# O IP do cliente é detetado automaticamente atrás de proxies internos e CDNs (incluindo Cloudflare) — deixe vazio.
# Defina apenas para um proxy invulgar cujo par de transporte seja um endereço PÚBLICO a confiar (IP/CIDR ou nome de host).
SECURITY_TRUSTED_PROXIES=

# Application
LOG_LEVEL=INFO
SPRING_PROFILES_ACTIVE=prod

Guarda o teu ficheiro .env imediatamente. Guarda uma cópia fora deste PC. Se perderes o DB_ENCRYPTION_KEY, os campos cifrados tornam-se permanentemente ilegíveis.

Passo 3 — Criar o ficheiro Docker Compose

Cria um ficheiro chamado docker-compose.yml:

services:
  postgres:
    image: postgres:18-alpine
    cpus: 4.0
    mem_limit: 512m
    environment:
      POSTGRES_DB: ${DB_NAME}
      POSTGRES_USER: ${DB_USERNAME}
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      PGDATA: /var/lib/postgresql/data   # required for the postgres:18 image
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${DB_USERNAME}"]
      interval: 10s
      timeout: 5s
      retries: 10
    restart: unless-stopped

  gotenberg:
    image: gotenberg/gotenberg:8
    cpus: 2.0
    mem_limit: 448m
    environment:
      LOG_LEVEL: info
    healthcheck:
      test: ["CMD", "curl", "-fsS", "http://localhost:3000/health"]
      interval: 10s
      timeout: 5s
      retries: 5
    restart: unless-stopped

  backend:
    image: ghcr.io/lesisty7/quotenode/quotenode-api:latest
    cpus: 4.0
    mem_limit: 1792m
    depends_on:
      postgres: { condition: service_healthy }
      gotenberg: { condition: service_healthy }
    env_file: .env
    environment:
      SPRING_PROFILES_ACTIVE: prod
      JOBS_MODE: web
      PDF_ENABLED: "true"
      PDF_GOTENBERG_URL: http://gotenberg:3000
    volumes:
      - backend_uploads:/app/data/uploads
      - backend_pdfs:/app/data/pdfs
    healthcheck:
      test: ["CMD", "curl", "-fsS", "http://localhost:8080/health"]
      interval: 15s
      timeout: 10s
      retries: 5
      start_period: 45s
    restart: unless-stopped

  frontend:
    image: ghcr.io/lesisty7/quotenode/quotenode-frontend:latest
    cpus: 2.0
    mem_limit: 192m
    depends_on:
      backend: { condition: service_healthy }
    ports:
      - "80:80"
      - "443:443"
    healthcheck:
      test: ["CMD", "curl", "-fsS", "http://localhost:80/"]
      interval: 15s
      timeout: 5s
      retries: 3
    restart: unless-stopped

volumes:
  postgres_data:
  backend_uploads:
  backend_pdfs:

Passo 4 — Iniciar o QuoteNode

docker compose up -d

O Docker vai descarregar as imagens no primeiro arranque. Acompanha o início:

docker compose logs -f backend

Aguarda até ver Started QuoteNodeApplication.

Passo 5 — Abrir o QuoteNode

Navega para http://192.168.1.50 (ou o endereço do teu PC) a partir de qualquer dispositivo na LAN.

Credenciais de acesso predefinidas:

Campo	Valor
Email	`[email protected]`
Password	`Admin123!`

Altera a password predefinida imediatamente após iniciar sessão.

Firewall Windows

Permite TCP de entrada no porto 80 para acesso HTTP desde a LAN.
Permite TCP de entrada no porto 443 apenas se configurares HTTPS.
Não expões o PostgreSQL à LAN a menos que tenhas uma necessidade administrativa específica.
Mantém o Docker Desktop a correr sob uma conta e política de arranque apropriadas para o teu escritório.

O que está a correr?

Container	O que faz	Uso de RAM
`postgres`	Armazena todos os teus dados	~256 MB
`backend`	Servidor API Java, lógica de negócio	~512 MB – 1,5 GB
`gotenberg`	Converte HTML para PDF (baseado em Chromium)	~200 MB
`frontend`	Serve a interface web + reverse proxy	~20 MB

Total: aproximadamente 1,5 – 2,5 GB de RAM.

Comandos habituais

# Check service status
docker compose ps

# View logs
docker compose logs -f backend

# Stop QuoteNode
docker compose down

# Update to the latest version
docker compose pull && docker compose up -d

Manter os teus segredos seguros

Segredo	O que protege	Se perdido
`DB_PASSWORD`	Acesso à base de dados	Recuperável — reiniciar via ferramentas de administração PostgreSQL
`DB_ENCRYPTION_KEY`	Códigos MFA, password SMTP, chave API FX, campos PII	Permanentemente ilegível
`TIMING_TOKEN_SECRET`	Tokens anti-timing-attack	Regenerar — utilizadores re-autenticam-se
`PUBLIC_LINK_PASSWORD_SESSION_SECRET`	Sessões de links públicos	Regenerar — as sessões ativas expiram

O segredo crítico é o DB_ENCRYPTION_KEY. Guarda backups do .env fora deste PC. Ver Resolução de problemas de instalação para os passos de recuperação.

Próximos passos recomendados

Configura backups e testa um restore.
Usa Resolução de problemas de instalação para problemas de CORS ou links.
Passa para servidor público Ubuntu ou Coolify antes de enviar links públicos a clientes externos.