Instalación con Docker
Instale NasDash en el puerto 2504 con datos persistentes y conexiones Docker opcionales.
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.
La gestión de Docker es opcional. Elija Portainer, Dockhand, una API compatible con Docker HTTP(S) o un socket Unix. El proxy local es una opción; Portainer y Dockhand no lo necesitan. Consulte las conexiones Docker.
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
extra_hosts:
- "host.docker.internal:host-gateway"
restart: unless-stopped
# Optional local engine connection: docker compose --profile docker-proxy up -d
docker-proxy:
profiles: ["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-stoppedGuarde como docker-compose.yml. Prepare el acceso a datos antes del arranque. Las órdenes siguientes son solo para directorio Linux nuevo vacío y UID:GID predeterminado. Para datos existentes, usuario propio o ACL Synology, siga primero la sección de permisos.
mkdir -p ./data
sudo chown 1001:1001 ./data
sudo chmod 700 ./data
docker compose pull
docker compose up -d --force-recreate
docker compose ps
docker compose logs nasdashAbra http://192.0.2.10:2504 desde la red local (sustituya la dirección de ejemplo) o http://localhost:2504 en el host. Introduzca el código de configuración y siga la guía de primer inicio. No se necesita una conexión Docker para iniciar NasDash.
El comando predeterminado inicia solo NasDash. Para usar el proxy local opcional, ejecute el comando siguiente y elija Dirección en Ajustes → Integraciones → Docker. Introduzca docker-proxy en el campo de host y 2375 en el de puerto; el destino resultante es http://docker-proxy:2375. Mantenga el perfil activado al recrear los contenedores y conserve el montaje de datos existente.
docker compose --profile docker-proxy up -dEl proxy opcional no publica puertos del host; DELETE=0 desactiva eliminaciones. pid: host comparte la visibilidad de procesos y puede quitarse si no es necesario; las fuentes remotas no lo necesitan. host.docker.internal permite acceder a servicios del host. Nunca publique una API Docker sin autenticar.
En una instalación nueva, NasDash arranca en modo privado, crea solo admin, guarda sus claves criptográficas y muestra una sola vez Setup code: XXXX-XXXX-XXXX en los registros. Este código es la primera contraseña del administrador; NASDASH_ADMIN_PASSWORD la sustituye si está definido. El archivo .env opcional sirve para ajustes avanzados. Inicio empieza con un reloj y un widget del tiempo aunque se omita la guía, sin servicios, dispositivos ni host Docker de ejemplo. Las instalaciones existentes conservan sus ajustes y cuentas.
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 downNo añadas -v durante una parada normal. Consulta Docker y proxy y Actualizaciones.
Synology y permisos de la carpeta de datos
La imagen se ejecuta con UID:GID 1001:1001. Antes del primer inicio, cree la carpeta de datos en el host y conceda a esa identidad acceso de lectura/escritura. En Synology, utilice una cuenta DSM dedicada con ACL de lectura/escritura en esta carpeta. Ejecute id nasdash-user por SSH (sustituya el nombre de ejemplo) y añada su identidad numérica solo al servicio NasDash. Este fragmento usa valores de ejemplo, no valores universales para NAS:
services:
nasdash:
user: "1026:100"Conserve el archivo Compose completo y el montaje de datos existente. Cree la carpeta antes de iniciar; compruebe también las ACL heredadas, el acceso a los directorios superiores, los archivos existentes y logos. Las variables PUID/PGID no son compatibles. Cambiar user no transfiere la propiedad. No utilice root, chmod 777 ni elimine datos para corregir el acceso. Reconstruir la imagen no repara los permisos del host. Si un Compose antiguo rechaza env_file.required, quite todo ese bloque opcional cuando no use .env, o utilice env_file: .env con su archivo existente.
En Linux, prepare una nueva carpeta ./data vacía con mkdir -p ./data, sudo chown 1001:1001 ./data y sudo chmod 700 ./data. Haga una copia de seguridad y detenga las instalaciones existentes antes de cambiar el acceso; conserve su montaje de datos.
Las imágenes a partir de la versión 0.2.2 comprueban el acceso antes del inicio e indican el UID:GID real si los datos, logos o archivos existentes no son accesibles. Corrija los permisos y vuelva a crear el contenedor. Las pruebas UID/GID en Docker Linux no sustituyen la validación en un DSM real.