Cómo iniciar una aplicación automáticamente en Windows Server con NSSM

Crea el directorio de herramientas y descarga NSSM desde 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

El archivo nssm.exe ahora vive en C:\Tools\nssm\nssm.exe. Usa siempre la build win64 en servidores modernos.

Añade NSSM al PATH del sistema para invocar nssm desde cualquier directorio:

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

Cierra PowerShell y ábrelo de nuevo para recargar el PATH. Confirma con nssm version — debe responder NSSM version 2.24.

Instala el servicio apuntando al intérprete y al script. Sustituye las rutas por las de tu aplicación:

nssm install MiApp "C:\Program Files\nodejs\node.exe" "C:\apps\miapp\server.js"

Para aplicaciones Python:

nssm install MiApp "C:\Python312\python.exe" "C:\apps\miapp\app.py"

Para aplicaciones Java:

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

El nombre del servicio (MiApp) es el que aparece en services.msc y en sc query. Usa nombres descriptivos sin espacios.

Configura el directorio de trabajo de la aplicación. Sin esto, las rutas relativas en el código (logs, archivos de configuración, módulos) se rompen porque el servicio arranca en C:\Windows\System32 por defecto:

nssm set MiApp AppDirectory "C:\apps\miapp"

Este es el error de configuración más común en una primera instalación. Anótalo: AppDirectory siempre apunta al directorio que contiene el script de entrada.

Define las variables de entorno que la aplicación espera. NSSM acepta múltiples variables separadas por \0 (escape literal), o las defines una a una:

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

Las variables sensibles (tokens, contraseñas) pueden ir aquí, pero ten en cuenta que el registro de Windows es legible por cualquier admin. Para secretos de verdad, prefiere leerlos desde un archivo .env protegido por ACL o desde un vault.

Configura logs de stdout y stderr — sin esto, cualquier mensaje que la aplicación imprima simplemente desaparece:

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

AppRotateBytes 10485760 rota cuando el archivo alcanza 10 MB. Sin rotación, un log olvidado crece hasta llenar el disco.

Configura la política de restart en caso de crash. NSSM ofrece tres modos: Restart (predeterminado — siempre reinicia), Ignore (no hace nada) y Exit (no reinicia). Para producción, mantén el valor por defecto pero ajusta el delay:

nssm set MiApp AppExit Default Restart
nssm set MiApp AppRestartDelay 5000

Un delay de 5 segundos evita un bucle de crash apretado consumiendo CPU si la aplicación se rompe nada más arrancar.

Marca el servicio como Automatic (arranca en el boot) y configura las dependencias de red:

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

El espacio después del = es obligatorio — sintaxis peculiar de sc.exe. La dependencia garantiza que la pila TCP/IP y el cliente DNS estén listos antes de que el servicio arranque — sin esto, las aplicaciones que hacen lookup DNS en el startup fallan aleatoriamente en el boot.

Arranca el servicio ahora:

nssm start MiApp

Deberías ver MiApp: START: The operation completed successfully.. Si recibes un error, salta a la sección de verificación más abajo antes de seguir.

Confirma que el servicio está corriendo:

Get-Service MiApp

La columna Status debe mostrar Running y StartType debe ser Automatic. Si aparece Stopped, abre C:\apps\miapp\logs\stderr.log — el error real de la aplicación está ahí.

Prueba el endpoint de la aplicación:

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

Sustituye el puerto por el que hayas configurado. Una respuesta 200 OK confirma que está atendiendo dentro de la sesión 0 correctamente.

Reinicia el servidor para validar el auto-arranque de verdad. Esta es la única forma fiable de garantizar que va a funcionar mañana cuando no estés mirando:

Restart-Computer -Force

Reconecta por RDP tras unos 60 segundos y ejecuta Get-Service MiApp de nuevo. Estado Running sin que hayas hecho nada = configuración correcta.