Pular para o conteúdo principal

Instalação no aaPanel

Este procedimento instala o ERP Ingressos usando o painel de hospedagem aaPanel, com suporte a Nginx e proxy reverso.

Pré-requisitos​

  • Servidor com aaPanel instalado
  • Docker instalado e ativo no aaPanel
  • Docker Compose disponível
  • Domínios configurados e apontando para o IP do servidor
  • Certificados SSL ativo no aapanel

Passo 1: Preparar o ambiente no aaPanel​

  1. No painel aaPanel, vá em Docker → Gerenciador de Imagens e confirme que o Docker está instalado.
  2. Crie o diretório para o projeto:
mkdir -p /www/wwwroot/erp-eventos
cd /www/wwwroot/erp-eventos
  1. Copie os arquivos da pasta install/aapanel/ do repositório para este diretório.

  2. Copie o arquivo de exemplo de variáveis de ambiente:

cp .env.example .env
  1. Edite o arquivo .env e ajuste:
# Banco de dados
POSTGRES_USER=erp_user
POSTGRES_PASSWORD=senha_segura_aqui
POSTGRES_DB=erp_ingressos

# Token de autenticação (exatamente 32 caracteres)
TOKEN_SECRET=$(openssl rand -hex 16)

# URLs públicas (ajuste para seus domínios)
PUBLIC_API_URL=https://api.seudominio.com.br
NEXT_PUBLIC_PDV_URL=https://pdv.seudominio.com.br
NEXT_PUBLIC_CAEX_URL=https://caex.seudominio.com.br
ALLOWED_ORIGINS=https://seudominio.com.br,https://www.seudominio.com.br

Importante: O TOKEN_SECRET deve ter exatamente 32 caracteres hexadecimais.

Passo 2: Cadastrar o Compose no aaPanel​

  1. No painel aaPanel, vá em Docker → Compose.

  2. Clique no botão verde Adicionar Compose.

  3. Na modal Adicionar compose, preencha:

    • Nome do Compose: erp-eventos
    • Conteúdo do Compose: cole o conteúdo abaixo (do arquivo docker-compose.yml)
    • Conteúdo .env: cole o conteúdo abaixo (do arquivo .env)
  4. Clique em Confirmar.

Após adicionar, o projeto aparecerá na lista (exemplo: erp-eventos) com as opções Parar, Reiniciar, Atualizar Imagem e Excluir.

⏱️ Observação: Após clicar em Confirmar, pode demorar até 2 minutos para todos os serviços ficarem ativos. Aguarde antes de testar os domínios.

Conteúdo do docker-compose.yml​

Atenção: Os domínios abaixo usam seudominio.com.br como exemplo. Substitua por seus próprios domínios antes de colar no campo Conteúdo do Compose.

Copie o conteúdo abaixo para o campo Conteúdo do Compose:

name: erp-eventos

x-web: &web
pull_policy: always
restart: unless-stopped
depends_on:
- backend
environment:
APP_ENV: production
HOSTNAME: 0.0.0.0
PORT: '3000'
API_URL: http://backend:8080
NEXT_PUBLIC_API_URL: ${PUBLIC_API_URL}
NEXT_PUBLIC_ORGANIZER_URL: ${NEXT_PUBLIC_ORGANIZER_URL}
NEXT_PUBLIC_FRONTEND_URL: ${NEXT_PUBLIC_FRONTEND_URL}
NEXT_PUBLIC_MANAGER_URL: ${NEXT_PUBLIC_MANAGER_URL}
NEXT_PUBLIC_CLIENTS_URL: ${NEXT_PUBLIC_CLIENTS_URL}
NEXT_PUBLIC_PDV_URL: ${NEXT_PUBLIC_PDV_URL:-https://pdv.seudominio.com.br}
NEXT_PUBLIC_CAEX_URL: ${NEXT_PUBLIC_CAEX_URL:-https://caex.seudominio.com.br}
ORGANIZER_SITE_URL: ${NEXT_PUBLIC_ORGANIZER_URL}
CLIENT_SITE_URL: ${NEXT_PUBLIC_CLIENTS_URL}
PUBLIC_SITE_URL: ${NEXT_PUBLIC_FRONTEND_URL}

services:
database:
image: docker.io/rodadecuiaapp/erp-eventos-database:latest
pull_policy: always
restart: unless-stopped
environment:
POSTGRES_USER: ${POSTGRES_USER:?Defina POSTGRES_USER no .env}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?Defina POSTGRES_PASSWORD no .env}
POSTGRES_DB: ${POSTGRES_DB:?Defina POSTGRES_DB no .env}
volumes:
- postgres_data:/var/lib/postgresql
healthcheck:
test: [CMD-SHELL, 'pg_isready -U "$${POSTGRES_USER}" -d "$${POSTGRES_DB}"']
interval: 5s
timeout: 5s
retries: 20
start_period: 30s

backend:
image: docker.io/rodadecuiaapp/erp-eventos-backend:latest
pull_policy: always
restart: unless-stopped
depends_on:
database:
condition: service_healthy
environment:
APP_ENV: production
PORT: '8080'
DATABASE_URL: postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@database:5432/${POSTGRES_DB}?sslmode=disable
TOKEN_SECRET: ${TOKEN_SECRET:?Defina TOKEN_SECRET com 32 caracteres}
ALLOWED_ORIGINS: ${ALLOWED_ORIGINS:?Defina os domínios HTTPS}
PUBLIC_API_URL: ${PUBLIC_API_URL:?Defina a URL pública do backend}
UPLOAD_DIR: /app/uploads
SMTP_HOST: ${SMTP_HOST:-}
SMTP_PORT: ${SMTP_PORT:-587}
SMTP_FROM: ${SMTP_FROM:-}
SMTP_USER: ${SMTP_USER:-}
SMTP_PASSWORD: ${SMTP_PASSWORD:-}
ports:
- '127.0.0.1:${BACKEND_PORT:-8080}:8080'
volumes:
- banner_uploads:/app/uploads

organizer:
<<: *web
image: docker.io/rodadecuiaapp/erp-eventos-organizer:latest
ports:
- '127.0.0.1:${ORGANIZER_PORT:-3001}:3000'

frontend:
<<: *web
image: docker.io/rodadecuiaapp/erp-eventos-frontend:latest
ports:
- '127.0.0.1:${FRONTEND_PORT:-3002}:3000'

manager:
<<: *web
image: docker.io/rodadecuiaapp/erp-eventos-manager:latest
ports:
- '127.0.0.1:${MANAGER_PORT:-3003}:3000'

clients:
<<: *web
image: docker.io/rodadecuiaapp/erp-eventos-clients:latest
ports:
- '127.0.0.1:${CLIENTS_PORT:-3004}:3000'

pdv:
<<: *web
image: docker.io/rodadecuiaapp/erp-eventos-pdv:latest
ports:
- '127.0.0.1:${PDV_PORT:-3006}:3000'

caex:
<<: *web
image: docker.io/rodadecuiaapp/erp-eventos-caex:latest
ports:
- '127.0.0.1:${CAEX_PORT:-3007}:3000'

docs-site:
image: docker.io/rodadecuiaapp/erp-eventos-docs:latest
pull_policy: always
restart: unless-stopped
ports:
- '127.0.0.1:${DOCS_PORT:-3005}:80'

volumes:
postgres_data:
banner_uploads:

Conteúdo do .env​

Copie o conteúdo abaixo para o campo Conteúdo .env. Altere os valores marcados para os seus domínios e senhas reais:

# Configuração independente da instalação aaPanel.
# Use senha PostgreSQL sem caracteres reservados de URL (ou codifique a senha na URL).
POSTGRES_USER=seu_usuario_postgres
POSTGRES_PASSWORD=sua_senha_segura_aqui
POSTGRES_DB=seu_banco_de_dados

# Exatamente 32 caracteres. Gere uma chave com: openssl rand -hex 16
TOKEN_SECRET=SUA_CHAVE_DE_32_CARACTERES_AQUI

# Ajuste os domínios configurados nos proxies HTTPS do aaPanel.
ALLOWED_ORIGINS=https://seudominio.com.br,https://www.seudominio.com.br
PUBLIC_API_URL=https://api.seudominio.com.br
NEXT_PUBLIC_FRONTEND_URL=https://seudominio.com.br
NEXT_PUBLIC_ORGANIZER_URL=https://organizador.seudominio.com.br
NEXT_PUBLIC_MANAGER_URL=https://manager.seudominio.com.br
NEXT_PUBLIC_CLIENTS_URL=https://clientes.seudominio.com.br
NEXT_PUBLIC_PDV_URL=https://pdv.seudominio.com.br
NEXT_PUBLIC_CAEX_URL=https://caex.seudominio.com.br

# Portas locais dos destinos dos proxies.
BACKEND_PORT=8080
ORGANIZER_PORT=3001
FRONTEND_PORT=3002
MANAGER_PORT=3003
CLIENTS_PORT=3004
PDV_PORT=3006
CAEX_PORT=3007

# SMTP opcional para funcionalidades de email.
SMTP_HOST=
SMTP_PORT=587
SMTP_FROM=
SMTP_USER=
SMTP_PASSWORD=

Importante: O TOKEN_SECRET deve ter exatamente 32 caracteres hexadecimais. Não use valores reais de produção neste exemplo; substitua por seus próprios domínios e senhas.

Como gerar o TOKEN_SECRET​

Se não houver acesso a terminal local para gerar a chave, use um gerador online de token hexadecimal, como:

Atenção: ao usar geradores online, gere a chave em um ambiente privado e não compartilhe o resultado. Após gerar, cole imediatamente no campo TOKEN_SECRET do .env e feche a página do gerador.

Passo 3: Configurar domínios e proxy reverso​

No aaPanel, vá em Website e crie um site para cada domínio do ERP.

Configuração do Proxy Reverso​

Ao abrir o modal Criar proxy reverso, preencha os campos da seguinte forma:

CampoValor
Nome do proxyQualquer nome identificador (ex: proxy-api, proxy-organizer)
Diretório proxy/
URL de Destinohttp://127.0.0.1:PORTA (substitua PORTA pela porta do serviço)
Domínio Enviado$host

⚠️ Importante: No campo URL de Destino, sempre informe http://127.0.0.1: seguido da porta do serviço. Exemplo: http://127.0.0.1:8080 para a API.

Após salvar o proxy, a configuração do Nginx deve ficar assim:

proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;

Onde proxy_pass http://127.0.0.1:8080; corresponde ao valor informado no campo URL de Destino e proxy_set_header Host $host; preserva o cabeçalho Host original da requisição.

☁️ Observação sobre Cloudflare: O ERP Ingressos tem total suporte ao Cloudflare (nuvem laranja). O proxy reverso do aaPanel funciona normalmente com o Cloudflare ativado, não interferindo no funcionamento da aplicação. Você pode usar o Cloudflare para DNS, SSL e outras funcionalidades sem problemas.

Lista de Serviços e Portas​

Crie um site e um proxy reverso para cada domínio abaixo:

Domínio de exemploURL de Destino (Proxy)Serviço
api.seudominio.com.brhttp://127.0.0.1:8080Backend API
organizer.seudominio.com.brhttp://127.0.0.1:3001Painel Organizador
eventos.seudominio.com.brhttp://127.0.0.1:3002Frontend Público
manager.seudominio.com.brhttp://127.0.0.1:3003Manager (Superadmin)
clients.seudominio.com.brhttp://127.0.0.1:3004Portal do Cliente
pdv.seudominio.com.brhttp://127.0.0.1:3006PDV
caex.seudominio.com.brhttp://127.0.0.1:3007CAEX

Para cada site:

  1. Configure o certificado SSL (Let's Encrypt).
  2. Ative o Proxy Reverso apontando para o destino correspondente.
  3. Preserve o Host original e encaminhe X-Forwarded-Proto como HTTPS.
  4. Desative o cache do proxy para APIs, login e painéis autenticados.

Passo 4: Verificar a instalação​

Acesse os domínios cadastrados no navegador. Se as páginas carregarem normalmente, a instalação está concluída com sucesso.

Domínio de exemploServiço
https://api.seudominio.com.brBackend API
https://organizador.seudominio.com.brPainel Organizador
https://seudominio.com.brFrontend Público
https://manager.seudominio.com.brManager (Superadmin)
https://clientes.seudominio.com.brPortal do Cliente
https://pdv.seudominio.com.brPDV
https://caex.seudominio.com.brCAEX

Para o procedimento de atualização, consulte a página Atualização (aaPanel).

Solução de problemas​

ProblemaSolução
Erro 502/503 no proxyVerifique se o container do serviço está rodando (docker compose ps)
SSL não funcionaConfirme que o domínio aponta para o IP do servidor e o certificado está ativo
Erro de conexão com bancoO PostgreSQL fica apenas na rede interna; não publique a porta 5432
Imagens privadasFaça docker login antes de iniciar o Compose