Instalação

O BrutusForge roda em Windows x64 como um stack completo (Postgres + API + Web + Bot), registrado como 4 Windows Services. A instalação foi feita para ser one-click.

Requisitos

• Windows 10 versão 1803+ ou Windows 11 (x64)
• Windows Server 2019+ também suportado
• Privilégios de administrador (o instalador requer UAC)
• Mínimo 4 GB de RAM
• 2 GB livres em disco (~57 MB de download)
• Portas 3000, 3001 e 5432 livres
• Licença BrutusForge válida (BF-XXXX-XXXX-XXXX-XXXX)

Passo a passo

1. Baixe o instalador na sua área de cliente (requer licença ativa) ou direto no link de download da release.
2. Localize o arquivo BrutusForge_<versao>_x64-setup.exe na pasta de Downloads e clique duas vezes para executar. Você precisa de privilégios de Administrador ao rodar, não ao baixar.
3. O Windows pode exibir o aviso SmartScreen — veja a seção abaixo sobre como proceder com segurança.
4. Aceite o EULA e escolha a pasta de instalação (padrão: C:\BrutusForge).
5. O instalador provisiona o Postgres, aplica as migrations e instala o VC++ Redistributable automaticamente. Aguarde a conclusão.
6. Após instalar, edite C:\BrutusForge\.env e adicione sua chave:

LICENSE_KEY=BF-XXXX-XXXX-XXXX-XXXX

7. Reinicie o computador (ou reinicie os serviços via Launcher na bandeja → "Reiniciar todos").
8. Abra http://localhost:3000/admin e faça o primeiro login via Discord OAuth.

Aviso SmartScreen do Windows

Ao executar o .exe pela primeira vez, o Windows pode exibir a tela "O Windows protegeu seu computador". Isso é esperado em fase early-access — certificados EV/OV para assinatura de código custariam valores proibitivos para um produto novo, mas o Updater interno é protegido por assinatura Ed25519 verificável.

Como prosseguir com segurança:

1. Baixe o instalador via botão Download na sua área de cliente.
2. Execute o .exe baixado (duplo clique).
3. Quando aparecer "O Windows protegeu seu computador", clique em "Mais informações" (link azul, lado esquerdo da janela).
4. Clique no botão "Executar mesmo assim" que aparece logo abaixo.
5. Aceite o UAC clicando em "Sim" para autorizar.
6. Aguarde a instalação automática — o VC++ Redistributable é instalado se necessário.
7. Reinicie o computador quando solicitado, ou abra o BrutusForge Launcher pelo menu Iniciar.

Como verificar a integridade do instalador

Antes de executar, você pode confirmar que o arquivo não foi adulterado comparando o hash SHA-256. Abra o PowerShell e execute:

Get-FileHash "$env:USERPROFILE\Downloads\BrutusForge_<versao>_x64-setup.exe" -Algorithm SHA256 | Select-Object Hash

O checksum SHA-256 esperado é publicado em cada release, junto com o instalador, na página de download.

Problemas comuns

Erro "LICENSE_INVALID" após configurar

Aguarde até 1 minuto para o LicenseGuard revalidar. Se persistir, verifique se o LICENSE_KEY no .env bate exatamente com o e-mail de compra.

Portas em uso

Pare manualmente as aplicações que usam as portas listadas antes de rodar o instalador. O instalador encerra o Launcher automaticamente se já estiver rodando.

HWID mudou (troca de máquina ou reinstalação)

Acesse Minha conta → License → Transferir HWID (1× gratuito a cada 30 dias). Se já usou a transferência este mês, contate o suporte.

Expondo em domínio público

Por padrão tudo roda em localhost. Se quiser acessar de outras máquinas ou expor na internet, veja o guia de domínio público (Cloudflare Tunnel, reverse proxy, ajustes de CORS e Discord OAuth).

Empresas que exigem executável assinado por CA

Se sua organização exige um executável assinado por CA reconhecida (EV/OV), entre em contato via suporte@lucassrdev.com.br. Estamos avaliando assinar releases futuras conforme a base de clientes crescer.

Desinstalação

Use Apps e Recursos do Windows ou execute unins000.exe em C:\BrutusForge. O desinstalador pergunta se deseja remover dados + .env (padrão sim, contém secrets).