BrutusForge

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

Requisitos

Windows 10 versao 1803+ ou Windows 11 (x64)
Windows Server 2019+ tambem suportado
Privilegios de administrador (instalador requer UAC)
Minimo 4 GB de RAM
2 GB livres em disco (~57 MB de download)
Portas 3000, 3001, 5432 livres
Licenca BrutusForge valida (BF-XXXX-XXXX-XXXX-XXXX)

Passo a passo

Baixe o instalador em sua area de cliente (requer licenca ativa) ou diretamente no link de download da release.
Localize o arquivo BrutusForge_1.0.0_x64-setup.exe na pasta de Downloads e clique duas vezes para executar. Voce precisara de privilegios de Administrador ao rodar, nao ao baixar.
⚠️ O Windows pode exibir o aviso SmartScreen — veja a secao abaixo sobre como proceder com seguranca.
Aceite o EULA e escolha a pasta de instalacao (default: C:\BrutusForge).
O instalador provisiona o Postgres, aplica as migrations e instala o VC++ Redistributable automaticamente. Aguarde a conclusao.
Apos instalar, edite C:\BrutusForge\.env e adicione sua chave:
```
LICENSE_KEY=BF-XXXX-XXXX-XXXX-XXXX
```
Reinicie o computador (ou reinicie os services via Launcher na bandeja → "Reiniciar todos").
Abra http://localhost:3000/admin e faca 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 e esperado em fase early-access — certificados EV/OV para assinatura de codigo custariam valores proibitivos para um produto novo, mas o Updater interno e protegido por assinatura Ed25519 verificavel.

Como prosseguir com seguranca:

Baixe o instalador via botao Download na sua area de cliente.
Execute o .exe baixado (duplo clique).
Quando aparecer "O Windows protegeu seu computador" → clique em "Mais informacoes" (link azul, lado esquerdo da janela).
Clique no botao "Executar mesmo assim" que aparecer logo abaixo.
Aceite o UAC clicando em "Sim" para autorizar.
Aguarde a instalacao automatica — o VC++ Redistributable e instalado se necessario.
Reinicie o computador quando solicitado, ou abra o BrutusForge Launcher pelo menu Iniciar.

Como verificar a integridade do instalador

Antes de executar, voce pode confirmar que o arquivo nao foi adulterado comparando o hash SHA-256. Abra o PowerShell e execute:

Get-FileHash "$env:USERPROFILE\Downloads\BrutusForge_1.0.0_x64-setup.exe" -Algorithm SHA256 | Select-Object Hash

O valor esperado para a versao v1.0.0-rc13 e:

d79a7c6daa350d7e4d2c54513ea93a995feb6f52349eb458005439d813e46e15

Se o hash divergir, nao execute o arquivo e entre em contato via suporte@lucassrdev.com.br.

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 encerra o Launcher automaticamente 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).

Empresas que exigem executavel assinado por CA

Se sua organizacao exige um executavel 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.

Desinstalacao

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