Iniciar aplicação automaticamente com Windows Server (NSSM + sc.exe)

Crie o diretório de ferramentas e baixe o NSSM pelo PowerShell:

New-Item -ItemType Directory -Force -Path C:\Tools\nssm
Invoke-WebRequest -Uri "https://nssm.cc/release/nssm-2.24.zip" -OutFile C:\Tools\nssm.zip
Expand-Archive -Path C:\Tools\nssm.zip -DestinationPath C:\Tools\nssm-temp
Copy-Item C:\Tools\nssm-temp\nssm-2.24\win64\nssm.exe C:\Tools\nssm\
Remove-Item C:\Tools\nssm.zip, C:\Tools\nssm-temp -Recurse -Force

O arquivo nssm.exe agora vive em C:\Tools\nssm\nssm.exe. Use sempre a build win64 em servidores modernos.

Adicione o NSSM ao PATH do sistema pra chamar nssm de qualquer diretório:

$old = [Environment]::GetEnvironmentVariable("Path", "Machine")
[Environment]::SetEnvironmentVariable("Path", "$old;C:\Tools\nssm", "Machine")

Feche o PowerShell e abra de novo pra recarregar o PATH. Confirme com nssm version — deve responder NSSM version 2.24.

Instale o serviço apontando pro interpretador e o script. Substitua os caminhos pelos da sua aplicação:

nssm install MeuApp "C:\Program Files\nodejs\node.exe" "C:\apps\meuapp\server.js"

Pra aplicações Python:

nssm install MeuApp "C:\Python312\python.exe" "C:\apps\meuapp\app.py"

Pra aplicações Java:

nssm install MeuApp "C:\Program Files\Java\jdk-21\bin\java.exe" "-jar C:\apps\meuapp\app.jar"

O nome do serviço (MeuApp) é o que aparece em services.msc e no sc query. Use nomes descritivos sem espaços.

Configure o diretório de trabalho da aplicação. Sem isso, caminhos relativos no código (logs, arquivos de config, módulos) quebram porque o serviço inicia em C:\Windows\System32 por default:

nssm set MeuApp AppDirectory "C:\apps\meuapp"

Esse é o erro de configuração mais comum em primeira instalação. Anote: AppDirectory sempre aponta pro diretório que contém o script de entrada.

Defina variáveis de ambiente que a aplicação espera. NSSM aceita múltiplas variáveis separadas por \0 (escape literal), ou você seta uma de cada vez:

nssm set MeuApp AppEnvironmentExtra "NODE_ENV=production" "PORT=3000" "DATABASE_URL=postgres://..."

Variáveis sensíveis (tokens, senhas) podem ir aqui, mas considere que o registro do Windows é legível por qualquer admin. Pra secrets de verdade, prefira ler de arquivo .env protegido por ACL ou de um cofre.

Configure logs de stdout e stderr — sem isso, qualquer mensagem que a aplicação imprime simplesmente some:

New-Item -ItemType Directory -Force -Path C:\apps\meuapp\logs
nssm set MeuApp AppStdout "C:\apps\meuapp\logs\stdout.log"
nssm set MeuApp AppStderr "C:\apps\meuapp\logs\stderr.log"
nssm set MeuApp AppRotateFiles 1
nssm set MeuApp AppRotateOnline 1
nssm set MeuApp AppRotateBytes 10485760

AppRotateBytes 10485760 rotaciona quando o arquivo atinge 10 MB. Sem rotação, um log esquecido cresce até encher o disco.

Configure política de restart em caso de crash. NSSM oferece três modos: Restart (default — sempre reinicia), Ignore (não faz nada) e Exit (não reinicia). Pra produção, mantenha o default mas ajuste o delay:

nssm set MeuApp AppExit Default Restart
nssm set MeuApp AppRestartDelay 5000

Delay de 5 segundos evita loop de crash apertado consumindo CPU se a aplicação está quebrando logo no startup.

Marque o serviço como Automatic (sobe no boot) e configure dependências de rede:

sc config MeuApp start= auto
sc config MeuApp depend= Tcpip/Dnscache

O espaço depois do = é obrigatório — sintaxe peculiar do sc.exe. A dependência garante que a pilha TCP/IP e o cliente DNS estejam prontos antes do serviço iniciar — sem isso, aplicações que fazem lookup DNS no startup falham aleatoriamente no boot.

Inicie o serviço agora:

nssm start MeuApp

Você deve ver MeuApp: START: The operation completed successfully.. Se receber erro, pule pra seção de verificação abaixo antes de seguir.

Confirme que o serviço está rodando:

Get-Service MeuApp

A coluna Status deve mostrar Running e StartType deve ser Automatic. Se aparecer Stopped, abra C:\apps\meuapp\logs\stderr.log — o erro real da aplicação está lá.

Teste o endpoint da aplicação:

Invoke-WebRequest http://localhost:3000 -UseBasicParsing | Select-Object StatusCode, Content

Substitua a porta pela que você configurou. Resposta 200 OK confirma que está atendendo dentro da sessão 0 corretamente.

Reinicie o servidor pra validar o auto-start de verdade. Esta é a única forma confiável de garantir que vai funcionar amanhã quando você não estiver olhando:

Restart-Computer -Force

Reconecte por RDP após uns 60 segundos e rode Get-Service MeuApp de novo. Status Running sem você ter feito nada = configuração correta.