Ir al contenido

Tu servidor Node.js

Todas las variables de arranque

Qué hace cada opción de la pestaña Arranque de tu servidor Node.js, con sus valores predeterminados.

4 min de lectura

Todas estas opciones están en la pestaña Arranque del panel de control. Los cambios se aplican la próxima vez que inicias el servidor, salvo donde se indica que hace falta reinstalar.

Variable Predeterminado Para qué sirve
Repositorio Git vacío URL HTTPS de tu repositorio, por ejemplo https://github.com/usuario/proyecto.git. Déjala vacía si subes los archivos a mano. No pongas usuario ni contraseña dentro de la URL.
Rama Git vacío La rama que se descarga (main, develop…). Vacía usa la rama predeterminada del repositorio. Si la cambias, reinstala el servidor para que se aplique.
Usuario Git vacío Tu usuario de GitHub, GitLab o Bitbucket. Solo para repositorios privados.
Token Git vacío Token de acceso para repositorios privados, de preferencia de solo lectura. Nunca uses tu contraseña. Cualquier persona con acceso a esta pestaña puede verlo, pero nunca se escribe en los registros.
Actualización automática desactivada Descarga los últimos cambios del repositorio (git pull) en cada inicio. Si cambiaste en el servidor archivos que también cambiaron en el repositorio, la actualización se omite para no perder tu trabajo.
Subida manual de archivos desactivada Actívala si subiste tus archivos a mano (por el administrador de archivos o SFTP). Así la instalación no intenta descargar nada desde Git.

La guía paso a paso está en Conecta tu bot a GitHub.

Variable Predeterminado Para qué sirve
Archivo de inicio index.js El archivo principal de tu aplicación: .js, .mjs, .cjs, .ts, .mts o .cts. Puede estar en una carpeta, como src/index.ts o dist/main.js. Se ignora si defines un comando de inicio.
Comando de inicio vacío Un comando propio para iniciar, como npm start. Si lo defines, reemplaza al archivo de inicio.
Comando de compilación vacío Se ejecuta en cada inicio, antes de arrancar, por ejemplo npm run build. Si falla, el servidor no arranca.
Argumentos de la aplicación vacío Argumentos que tu código recibe en process.argv, como --debug --lang es. No sirven para variables de entorno: para eso usa un archivo .env.
Ejecutor de TypeScript tsx Cómo se ejecutan los archivos .ts. tsx es el recomendado (Node.js 18.19 o superior). node usa el soporte nativo (Node.js 22.18 o superior; no admite enum ni namespace). ts-node es la opción antigua y no funciona con el TypeScript 7 de las imágenes; si tu proyecto trae su propio ts-node, se usa ese.
Entorno (NODE_ENV) production El valor de NODE_ENV para tu aplicación: production, development o test.
Cargar archivo .env activada Carga las variables del archivo .env de la carpeta principal del servidor. Requiere Node.js 20.6 o superior. No se aplica si usas comando de inicio o ts-node: en esos casos carga el .env con el paquete dotenv desde tu código.
Opciones de Node vacío Opciones avanzadas de Node.js, como --enable-source-maps. Si no incluyes --max-old-space-size, la memoria se ajusta sola al 83 % de la RAM del servidor. Ver memoria personalizada.
Variable Predeterminado Para qué sirve
Gestor de paquetes npm Quién instala las dependencias: npm, pnpm, yarn, bun o auto (lo detecta por el campo packageManager de tu package.json o por tu archivo de bloqueo). Los gestores distintos de npm se descargan la primera vez en la carpeta .pm. pnpm requiere Node.js 18.12 o superior; Yarn 2 o superior requiere nodeLinker: node-modules en .yarnrc.yml.
Instalar dependencias al iniciar activada Instala las dependencias de tu package.json al iniciar, pero solo cuando cambia algo: el package.json, el archivo de bloqueo, el gestor o la versión de Node.js. Para forzar una instalación desde cero, borra la carpeta node_modules y reinicia.
Permitir scripts de instalación activada Deja que las dependencias ejecuten sus scripts de instalación. Los necesitan los módulos nativos como bcrypt, sqlite3 o sharp. Si tu proyecto no los usa, puedes desactivarla para más seguridad.
Instalar paquetes adicionales vacío Paquetes separados por espacios (express mongoose dotenv) que se agregan a tu proyecto en el próximo inicio. Quedan guardados en tu package.json.
Desinstalar paquetes vacío Paquetes que se quitan de tu proyecto. Se procesan antes que los adicionales.