Pular para o conteúdo
ALPHA ERP Central de Ajuda

Instalar o servidor

Passo a passo do instalador AlphaERP-Servidor - tipo de instalação, senha do banco, portas, serviços e o primeiro acesso ao Gerencial.

Como fazer 5 min de leitura Atualizado na versão 1.0.0.19.18

O instalador do servidor (AlphaERP-Servidor-<versão>.exe) prepara o computador que vai guardar os dados da loja: instala o banco de dados, o serviço do ALPHA ERP e o atalho do Gerencial. Faça isso uma vez, no computador escolhido para ser o servidor.

Antes de começar#

  • Confira os requisitos: Windows 64 bits, usuário administrador e IP fixo no servidor.
  • Tenha em mãos o instalador do servidor fornecido pela revenda/suporte.
  • Escolha uma senha para o banco de dados (no mínimo 6 caracteres) e guarde em lugar seguro. Ela será pedida de novo em toda atualização.

Passo a passo#

  1. Dê dois cliques no AlphaERP-Servidor-<versão>.exe e aceite o aviso do Windows (o instalador precisa de administrador).

  2. Pasta de instalação: deixe C:\AlphaERP (padrão). Os atalhos, os backups e as instruções de suporte contam com essa pasta. Se o servidor já estava instalado, o instalador mostra a pasta de antes: deixe como está (trocar a pasta não leva o banco de dados nem os backups).

  3. Tipo de instalação:

    • Servidor completo (API + MySQL + Gerencial) — o normal para uma loja nova. Instala tudo.
    • Usar um MySQL já instalado nesta máquina ou na rede — só se a loja já tiver um MySQL que deva ser usado.
    • Personalizada — escolher os componentes um a um.

    Os componentes são: API do Nascente (obrigatória, roda como serviço do Windows), MySQL 8.4, Gerencial (atalho na área de trabalho) e Ponte de IA (consulta dos dados da loja por IA, só leitura; opcional).

  4. Senha do banco de dados: digite a senha e confirme.

    • Instalação nova com o MySQL do instalador: esta passa a ser a senha do banco.
    • Reinstalação/atualização, ou MySQL que já existia: informe a senha atual do banco.

  5. Banco e portas: confira os campos. Na maioria das lojas basta avançar:

    • Servidor do MySQL, Porta do MySQL, Nome do banco e Usuário do MySQL — com o MySQL do instalador, o servidor e o usuário ficam travados.
    • Porta da API — padrão 8080. É a porta que os caixas, a Gestão de Estoque e o Gerencial usam. Anote: você vai precisar dela para instalar as estações.

  6. Confira o resumo e clique em Instalar. O instalador:

    • instala o MySQL e cria o banco (quando é instalação nova);
    • registra os serviços do Windows NascenteMySQL (banco) e NascenteAPI (sistema), que ligam sozinhos com o Windows;
    • libera a porta da API no Firewall do Windows, só para a rede local;
    • liga a API. Na primeira vez o sistema cria as tabelas do banco e pode levar 1 ou 2 minutos.

  7. No fim aparece "Servidor instalado e a API respondendo em http://127.0.0.1:8080" (com a porta escolhida) e os dados do primeiro acesso ao Gerencial. Anote o usuário e a senha mostrados.

  8. Abra o Nascente Gerencial (atalho na área de trabalho), entre com o usuário do primeiro acesso e troque a senha imediatamente em Administração → Usuários.

O que fica instalado#

ItemOnde
Sistema (API) e seus registros (logs)C:\AlphaERP\api e C:\AlphaERP\api\logs
Banco de dadosC:\AlphaERP\dados (nunca é apagado pelo desinstalador)
Backups automáticosC:\AlphaERP\backups (nunca é apagado pelo desinstalador; acesso só para administradores)
Gerencial (app)C:\AlphaERP\gerencial
Ligar / parar o servidorC:\AlphaERP\LIGAR SERVIDOR.bat e C:\AlphaERP\MATAR PROCESSO SERVIDOR.bat

No menu Iniciar → ALPHA ERP ficam os atalhos: Nascente Gerencial, Ligar o servidor, Parar o servidor, Logs da API, Restaurar backup, Criar nova base, Remover base, Migrar dados do HOST, Migrar dados do GERENTE, Configurar a ponte de IA e Desinstalar o ALPHA ERP.

Depois de instalar#

  1. Descubra o IP do servidor (no servidor: Configurações do Windows → Rede, ou no Prompt de Comando ipconfig) e confirme que ele é fixo.
  2. Instale as estações apontando para esse IP e porta: Instalar uma estação.
  3. Se a loja vem de outro sistema, faça a migração antes de começar a vender: Migrar do HOST ou Migrar do GERENTE.
  4. Siga o roteiro de Primeiros passos.

Problemas comuns#

Mensagem do instaladorO que fazer
"A senha e a confirmação estão diferentes."Digite a mesma senha nos dois campos.
"Informe uma senha com pelo menos 6 caracteres para o MySQL."Use uma senha maior.
"A porta 3306 já está em uso nesta máquina (provavelmente outro MySQL)."Já existe outro banco no computador. Troque a Porta do MySQL (ex.: 3307) ou escolha o tipo Usar um MySQL já instalado.
"A porta 8080 já está em uso nesta máquina. Escolha outra porta para a API (ex.: 8090)."Outro programa usa a porta. Escolha outra Porta da API e use essa mesma porta nas estações.
"A porta do MySQL e a da API precisam ser diferentes."Ajuste uma das duas.
"A senha informada não é a do MySQL que já estava instalado…"É uma reinstalação: rode o instalador de novo com a senha atual do banco.
"A API não respondeu na porta…"Espere 2 minutos e abra o Gerencial. Se não abrir, veja os registros em menu Iniciar → ALPHA ERP → Logs da API e chame o suporte.
"A instalação terminou, mas com problemas: …"A mensagem lista o que falhou e mostra onde está o log do instalador. Envie esse arquivo ao suporte.

Veja também#

Artigos relacionados