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 arranque estándar no necesita un socket Docker. Solo el perfil opcional del proxy local monta /var/run/docker.sock, una convención de Linux. Portainer y Dockhand funcionan sin ese montaje; Docker Desktop puede requerir ajustes de red. Consulte las conexiones Docker.
Desarrollo desde el código fuente
- Node.js
22.x, conforme al motor declarado y la imagen; - npm con lockfile del repositorio;
- Playwright Chromium para pruebas de navegador;
- Docker para comprobar imagen y 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.