Pular para o conteúdo principal

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 root ou com privilégios sudo
  • Memória RAM: mínimo 4 GB (recomendado 8 GB+)
  • Armazenamento: mínimo 50 GB livre (SSD recomendado)
  • Portas: 80 e 443 livres para o Traefik (HTTP/HTTPS) e portas locais 8080, 3001 a 3007 livres em 127.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:

  1. Verificação do sistema operacional: valida se a distribuição é Debian 12+, Ubuntu 24.04+, AlmaLinux 10+ ou Rocky Linux 10+.
  2. 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-plugin e openssl, e libera as portas 80 e 443 caso firewalld ou ufw estejam ativos.
  3. Diretório da instalação: solicita o caminho onde a aplicação ficará instalada (padrão: /opt/erp-ingressos).
  4. Banco de Dados e Chaves de Segurança:
    • Configura automaticamente o PostgreSQL com banco erp_ingressos, usuário erp_ingressos_user e senha aleatória forte gerada automaticamente.
    • Gera automaticamente a chave de 32 caracteres TOKEN_SECRET com openssl rand -hex 16 (basta pressionar ENTER para aceitar ou informar uma chave existente).
  5. 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_URL e ALLOWED_ORIGINS), permitindo confirmar com ENTER ou personalizar cada endereço.
    • Confirma as portas locais dos serviços (8080, 3001 a 3007) e pergunta opcionalmente se deseja configurar o servidor de e-mail SMTP.
  6. Geração dos arquivos e inicialização:
    • Cria automaticamente o docker-compose.yml (já com o serviço traefik e os labels de roteamento e SSL de cada container) e os arquivos .env preenchidos no diretório escolhido.
    • Baixa as imagens oficiais e sobe todos os containers com docker compose up -d.

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çoDomínio Público (Traefik HTTPS)Porta Local (127.0.0.1)Descrição
Frontend (Público)https://seudominio.com.br127.0.0.1:3002Loja pública e checkout de ingressos
Backend APIhttps://api.seudominio.com.br127.0.0.1:8080API REST/gRPC do sistema
Organizadorhttps://organizador.seudominio.com.br127.0.0.1:3001Painel do produtor de eventos
Managerhttps://manager.seudominio.com.br127.0.0.1:3003Superadministração da plataforma
Clienteshttps://clientes.seudominio.com.br127.0.0.1:3004Portal do participante
PDVhttps://pdv.seudominio.com.br127.0.0.1:3006Ponto de venda presencial
CAEXhttps://caex.seudominio.com.br127.0.0.1:3007Gestão de parceiros e expositores
Documentaçãohttps://docs.seudominio.com.br127.0.0.1:3005Central 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 -v caso queira preservar os dados do banco PostgreSQL, os certificados SSL e os arquivos de upload.

Solução de Problemas​

ProblemaSolução
Sistema operacional recusadoConfirme que utiliza Debian 12+, Ubuntu 24.04+, AlmaLinux 10+ ou Rocky Linux 10+ (cat /etc/os-release)
Certificado SSL não é emitidoVerifique 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 usoPare outros servidores web no host (como Apache ou Nginx) antes de subir o container traefik
Container não iniciaVerifique os logs com sudo docker compose logs <serviço> dentro de /opt/erp-ingressos
Erro de conexão com bancoConfirme se o container database está saudável (healthy) em sudo docker compose ps