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.0 o posterior;
  • Acceso a la línea de comandos con los permisos necesarios para ejecutar contenedores;
  • El puerto TCP 2504 disponible, 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

PreguntaElecció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 version

El 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.