Voltar
Docs / Instalacao

Guia de instalacao

Atualizado em 2026-04-19

O BrutusForge roda em Windows x64 como um stack completo (Postgres + Redis + API + Web + Bot), registrado como 5 Windows Services via NSSM. A instalacao foi feita pra ser one-click.

Requisitos

  • Windows 10/11 ou Windows Server 2019+
  • Privilegios de administrador (instalador requer UAC)
  • 2 GB livres em disco
  • Portas 3000, 3001, 5432, 6379 livres
  • Licenca BrutusForge valida (BF-XXXX-XXXX-XXXX-XXXX)

Passo a passo

  1. Baixe o instalador em sua area de cliente (requer licenca ativa).
  2. Execute BrutusForge-Setup-X.Y.Z-windows-x64.exe e aceite o EULA.
  3. Escolha a pasta de instalacao (default: C:\BrutusForge).
  4. Marque os componentes: Core (obrigatorio), Launcher (recomendado).
  5. Apos instalar, edite C:\BrutusForge\.env e adicione:
    LICENSE_KEY=BF-XXXX-XXXX-XXXX-XXXX
  6. Reinicie o servico via Launcher na bandeja (menu "Reiniciar todos") ou services.msc.
  7. Abra http://localhost:3000/admin e faca o primeiro login (Discord OAuth).

Problemas comuns

Erro "LICENSE_INVALID" apos configurar

Aguarde ate 1 minuto pra o LicenseGuard revalidar. Se persistir, verifique se o LICENSE_KEY no .env bate exatamente com o email de compra.

Portas em uso

Pare manualmente aplicacoes que usam as portas listadas antes de rodar o instalador. O installer faz taskkill do Launcher se ja estiver rodando.

HWID mudou (troca de maquina ou reinstall)

Acesse Minha conta -> License -> Transferir HWID (1x gratuito a cada 30 dias). Se ja usou a transferencia este mes, contate o suporte.

Expondo em dominio publico

Por default tudo roda em localhost. Se quiser acessar de outras maquinas ou expor na internet, veja o guia de dominio publico (Cloudflare Tunnel, reverse proxy, ajustes de CORS e Discord OAuth).

Desinstalacao

Use Apps & Features do Windows ou execute unins000.exe em C:\BrutusForge. O uninstaller pergunta se deseja remover dados + .env (default sim, contem secrets).