Your Node.js server
Todas las variables de arranque
Qué hace cada opción de la pestaña Arranque de tu servidor Node.js, con sus valores predeterminados.
This content is not available in your language yet.
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.
Código y repositorio
Sección titulada «Código y repositorio»| 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.
Cómo se inicia tu aplicación
Sección titulada «Cómo se inicia tu aplicación»| 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. |
Dependencias
Sección titulada «Dependencias»| 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. |