Instalação no Linux
A instalação do ERP Ingressos em servidores Linux é feita de forma automatizada por meio do script oficial install-erp-ingressos.sh.
O script instala automaticamente todas as dependências a partir das fontes oficiais (incluindo Docker Engine e Docker Compose), coleta as informações do seu ambiente de forma interativa, gera automaticamente os arquivos .env e docker-compose.yml (que já estão embutidos no instalador) e sobe todos os serviços junto com o Traefik já configurado como proxy reverso e emissor automático de certificados SSL (Let's Encrypt).
Pré-requisitos e Sistemas Homologados
Certifique-se de que o servidor atende aos seguintes requisitos antes de iniciar:
- Sistemas operacionais suportados:
- Debian: 12 ou superior
- Ubuntu: 24.04 ou superior
- AlmaLinux: 10 ou superior
- Rocky Linux: 10 ou superior
- Acesso: usuário
rootou com privilégiossudo - Memória RAM: mínimo 4 GB (recomendado 8 GB+)
- Armazenamento: mínimo 50 GB livre (SSD recomendado)
- Portas:
80e443livres para o Traefik (HTTP/HTTPS) e portas locais8080,3001a3007livres em127.0.0.1 - DNS: os domínios/subdomínios da aplicação devem apontar (registro tipo
A) para o IP público do servidor
Passo 1: Baixar o script de instalação
Você pode baixar o instalador install-erp-ingressos.sh diretamente pelo botão abaixo e enviá-lo ao seu servidor (via SCP/SFTP), ou baixá-lo diretamente pelo terminal do servidor:
⬇️ Baixar install-erp-ingressos.sh
Ou baixe diretamente no terminal do seu servidor Linux usando curl ou wget:
# Usando curl
curl -fsSLO https://docs.erpingressos.app.br/install-erp-ingressos.sh
# Ou usando wget
wget -O install-erp-ingressos.sh https://docs.erpingressos.app.br/install-erp-ingressos.sh
Passo 2: Executar o instalador e seguir as instruções
Conceda permissão de execução ao arquivo e execute o script como root (ou com sudo):
chmod +x install-erp-ingressos.sh
sudo ./install-erp-ingressos.sh
Basta seguir as instruções exibidas na tela. O instalador fará todo o processo em 6 etapas:
- Verificação do sistema operacional: valida se a distribuição é Debian 12+, Ubuntu 24.04+, AlmaLinux 10+ ou Rocky Linux 10+.
- Instalação de pacotes oficiais e firewall: configura o repositório oficial do Docker para a sua distribuição, instala
docker-ce,docker-ce-cli,containerd.io,docker-buildx-plugin,docker-compose-plugineopenssl, e libera as portas80e443casofirewalldouufwestejam ativos. - Diretório da instalação: solicita o caminho onde a aplicação ficará instalada (padrão:
/opt/erp-ingressos). - Banco de Dados e Chaves de Segurança:
- Configura automaticamente o PostgreSQL com banco
erp_ingressos, usuárioerp_ingressos_usere senha aleatória forte gerada automaticamente. - Gera automaticamente a chave de 32 caracteres
TOKEN_SECRETcomopenssl rand -hex 16(basta pressionarENTERpara aceitar ou informar uma chave existente).
- Configura automaticamente o PostgreSQL com banco
- Domínios, SSL no Traefik, Portas e SMTP:
- Ao informar seu domínio principal (ex:
seudominio.com.br) e o e-mail para o Let's Encrypt (ACME_EMAIL), o script preenche automaticamente as sugestões de URLs públicas e regras de roteamento do Traefik para todos os módulos (PUBLIC_API_URL,NEXT_PUBLIC_FRONTEND_URL,NEXT_PUBLIC_ORGANIZER_URL,NEXT_PUBLIC_MANAGER_URL,NEXT_PUBLIC_CLIENTS_URL,NEXT_PUBLIC_PDV_URL,NEXT_PUBLIC_CAEX_URL,PUBLIC_DOCS_URLeALLOWED_ORIGINS), permitindo confirmar comENTERou personalizar cada endereço. - Confirma as portas locais dos serviços (
8080,3001a3007) e pergunta opcionalmente se deseja configurar o servidor de e-mail SMTP.
- Ao informar seu domínio principal (ex:
- Geração dos arquivos e inicialização:
- Cria automaticamente o
docker-compose.yml(já com o serviçotraefike os labels de roteamento e SSL de cada container) e os arquivos.envpreenchidos no diretório escolhido. - Baixa as imagens oficiais e sobe todos os containers com
docker compose up -d.
- Cria automaticamente o
Passo 3: Acessar o Sistema (Roteamento via Traefik)
Assim que os containers iniciarem, o Traefik irá rotear automaticamente cada domínio para o respectivo serviço e emitir os certificados HTTPS via Let's Encrypt:
| Serviço | Domínio Público (Traefik HTTPS) | Porta Local (127.0.0.1) | Descrição |
|---|---|---|---|
| Frontend (Público) | https://seudominio.com.br | 127.0.0.1:3002 | Loja pública e checkout de ingressos |
| Backend API | https://api.seudominio.com.br | 127.0.0.1:8080 | API REST/gRPC do sistema |
| Organizador | https://organizador.seudominio.com.br | 127.0.0.1:3001 | Painel do produtor de eventos |
| Manager | https://manager.seudominio.com.br | 127.0.0.1:3003 | Superadministração da plataforma |
| Clientes | https://clientes.seudominio.com.br | 127.0.0.1:3004 | Portal do participante |
| PDV | https://pdv.seudominio.com.br | 127.0.0.1:3006 | Ponto de venda presencial |
| CAEX | https://caex.seudominio.com.br | 127.0.0.1:3007 | Gestão de parceiros e expositores |
| Documentação | https://docs.seudominio.com.br | 127.0.0.1:3005 | Central de ajuda e documentação |
Observação sobre SSL: O Traefik redireciona automaticamente todo o tráfego HTTP (porta 80) para HTTPS (porta 443) e armazena os certificados Let's Encrypt de forma persistente no volume
traefik_letsencrypt.
Comandos Úteis de Gerenciamento
Dentro do diretório de instalação (por padrão /opt/erp-ingressos), utilize os comandos abaixo:
cd /opt/erp-ingressos
# Verificar status de todos os containers
sudo docker compose ps
# Acompanhar logs do Traefik e emissão de certificados SSL
sudo docker compose logs -f traefik
# Ver logs do backend em tempo real
sudo docker compose logs -f backend
# Reiniciar um serviço específico
sudo docker compose restart backend
# Parar todos os serviços (mantendo os dados)
sudo docker compose down
# Atualizar o sistema para a versão mais recente
sudo docker compose pull
sudo docker compose up -d
Atenção: Nunca execute
docker compose down -vcaso queira preservar os dados do banco PostgreSQL, os certificados SSL e os arquivos de upload.
Solução de Problemas
| Problema | Solução |
|---|---|
| Sistema operacional recusado | Confirme que utiliza Debian 12+, Ubuntu 24.04+, AlmaLinux 10+ ou Rocky Linux 10+ (cat /etc/os-release) |
| Certificado SSL não é emitido | Verifique se os subdomínios apontam para o IP do servidor e se as portas 80 e 443 estão abertas (sudo docker compose logs traefik) |
| Porta 80 ou 443 já em uso | Pare outros servidores web no host (como Apache ou Nginx) antes de subir o container traefik |
| Container não inicia | Verifique os logs com sudo docker compose logs <serviço> dentro de /opt/erp-ingressos |
| Erro de conexão com banco | Confirme se o container database está saudável (healthy) em sudo docker compose ps |