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
- No painel aaPanel, vá em Docker → Gerenciador de Imagens e confirme que o Docker está instalado.
- Crie o diretório para o projeto:
mkdir -p /www/wwwroot/erp-eventos
cd /www/wwwroot/erp-eventos
-
Copie os arquivos da pasta
install/aapanel/do repositório para este diretório. -
Copie o arquivo de exemplo de variáveis de ambiente:
cp .env.example .env
- Edite o arquivo
.enve 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_SECRETdeve ter exatamente 32 caracteres hexadecimais.
Passo 2: Cadastrar o Compose no aaPanel
-
No painel aaPanel, vá em Docker → Compose.
-
Clique no botão verde Adicionar Compose.
-
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)
- Nome do Compose:
-
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.brcomo 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_SECRETdeve 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:
- Random.org String Generator — gere uma string aleatória de 32 caracteres hexadecimais (0-9, a-f).
- Password Generator — defina 32 caracteres e desative símbolos, usando apenas letras e números.
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_SECRETdo.enve 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:
| Campo | Valor |
|---|---|
| Nome do proxy | Qualquer nome identificador (ex: proxy-api, proxy-organizer) |
| Diretório proxy | / |
| URL de Destino | http://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:8080para 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 exemplo | URL de Destino (Proxy) | Serviço |
|---|---|---|
| api.seudominio.com.br | http://127.0.0.1:8080 | Backend API |
| organizer.seudominio.com.br | http://127.0.0.1:3001 | Painel Organizador |
| eventos.seudominio.com.br | http://127.0.0.1:3002 | Frontend Público |
| manager.seudominio.com.br | http://127.0.0.1:3003 | Manager (Superadmin) |
| clients.seudominio.com.br | http://127.0.0.1:3004 | Portal do Cliente |
| pdv.seudominio.com.br | http://127.0.0.1:3006 | PDV |
| caex.seudominio.com.br | http://127.0.0.1:3007 | CAEX |
Para cada site:
- Configure o certificado SSL (Let's Encrypt).
- Ative o Proxy Reverso apontando para o destino correspondente.
- Preserve o
Hostoriginal e encaminheX-Forwarded-Protocomo HTTPS. - 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 exemplo | Serviço |
|---|---|
| https://api.seudominio.com.br | Backend API |
| https://organizador.seudominio.com.br | Painel Organizador |
| https://seudominio.com.br | Frontend Público |
| https://manager.seudominio.com.br | Manager (Superadmin) |
| https://clientes.seudominio.com.br | Portal do Cliente |
| https://pdv.seudominio.com.br | PDV |
| https://caex.seudominio.com.br | CAEX |
Para o procedimento de atualização, consulte a página Atualização (aaPanel).
Solução de problemas
| Problema | Solução |
|---|---|
| Erro 502/503 no proxy | Verifique se o container do serviço está rodando (docker compose ps) |
| SSL não funciona | Confirme que o domínio aponta para o IP do servidor e o certificado está ativo |
| Erro de conexão com banco | O PostgreSQL fica apenas na rede interna; não publique a porta 5432 |
| Imagens privadas | Faça docker login antes de iniciar o Compose |