Primeros pasos

Instalación con Docker

Despliega NasDash en su puerto coherente 2504 con datos persistentes y el proxy de Docker.

NasDash utiliza el puerto 2504 en el host Docker y 2504 dentro del contenedor. El Compose listo para copiar guarda los datos en ./data. No sustituya esa carpeta por un volumen con nombre en una instalación existente.

Docker Compose listo para copiar

services:
  nasdash:
    image: ghcr.io/lucas-lepajollec/nasdash:latest
    ports:
      - "2504:2504"
    env_file:
      - path: .env
        required: false
    volumes:
      - ./data:/app/data
    pid: host
    depends_on:
      - docker-proxy
    extra_hosts:
      - "host.docker.internal:host-gateway"
    restart: unless-stopped

  docker-proxy:
    image: tecnativa/docker-socket-proxy:v0.5.0
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      CONTAINERS: 1
      IMAGES: 1
      VOLUMES: 1
      NETWORKS: 1
      INFO: 1
      POST: 1
      DELETE: 0
    restart: unless-stopped

Guárdalo como docker-compose.yml y ejecuta:

docker compose pull
docker compose up -d --force-recreate
docker compose ps
docker compose logs nasdash

Abre http://<server-ip>:2504 desde la LAN, o http://localhost:2504 en el host Docker. Configura la conexión Docker local como docker-proxy:2375.

El proxy no se publica en el host Docker. Solo permite las familias de API listadas; DELETE=0 mantiene desactivadas las eliminaciones. pid: host se conserva para las métricas del host y host.docker.internal permite acceder a sus otros servicios.

En el primer inicio, NasDash genera contraseñas fuertes y claves criptográficas estables, las conserva con sus datos y muestra las contraseñas iniciales una sola vez en los registros. El .env opcional sirve únicamente para ajustes avanzados explícitos; su ausencia no impide el inicio.

Instalación existente con volumen con nombre

Conserve nasdash-data:/app/data solo si la instancia ya usa ese volumen con nombre. No cambie el tipo de almacenamiento durante una actualización rutinaria.

Detener sin borrar datos

docker compose stop
docker compose down

No añadas -v durante una parada normal. Consulta Docker y proxy y Actualizaciones.