Primeros pasos
Prerrequisitos
Hardware, software, red y decisiones a preparar antes de la instalación.
Instalación de Docker recomendada
- Un host Linux con Docker Engine y Docker Compose
2.24.0o posterior; - Acceso a la línea de comandos con los permisos necesarios para ejecutar contenedores;
- El puerto TCP
2504disponible, o cualquier otro puerto de host elegido; - Almacenamiento persistente para la totalidad de
/app/data; - Acceso de red desde el contenedor de NasDash hacia las integraciones objetivo;
- Una estrategia de copia de seguridad independiente del disco o volumen principal.
El archivo Compose proporcionado monta /var/run/docker.sock, una convención de Linux. Docker Desktop puede ejecutar NasDash, pero el acceso local a Docker debe adaptarse, y este no es el camino validado por el archivo proporcionado.
Desarrollo desde el código fuente
- Node.js
20.9.0o superior; - Se recomienda Node.js 22 LTS, idéntico a la imagen de producción actual;
- npm con el archivo de bloqueo (lockfile) del repositorio;
- Playwright Chromium solo si ejecuta pruebas de navegador;
- Docker si valida la imagen y la persistencia.
Decisiones a tomar antes del primer arranque
| Pregunta | Elección recomendada |
|---|---|
| ¿Dónde almacenar los datos? | ./data de forma predeterminada; volumen con nombre solo como alternativa opcional para una instalación nueva |
| ¿Quién puede ver el panel? | Modo privado para una instancia que contenga información sensible |
| ¿Acceso remoto? | Tailscale o proxy inverso HTTPS; no publique el puerto 2504 directamente en Internet |
| ¿Acciones de Docker? | Mantenga POST=1 solo si es necesario y DELETE=0 de forma predeterminada |
| ¿Secreto inicial? | Deje que NasDash lo genere y conserve, o proporciónelo explícitamente en un despliegue avanzado |
Verificar Docker Compose
docker version
docker compose versionEl segundo comando debe indicar Compose 2.24.0 o posterior. Esta versión admite el .env opcional de la configuración lista para copiar. La sintaxis histórica docker-compose no es la utilizada por las guías.