Synology NAS

Guida all’installazione di XIQUIL su Synology NAS usando Container Manager (Docker).

Prerequisiti

• Synology NAS con DSM 7.2+
• Container Manager installato dal Package Center
• Almeno 2 GB di RAM disponibili

Passo 1: Scarica le immagini

1. Apri Container Manager > Registry
2. Cerca ghcr.io/justvitlab/xiquil e scarica il tag latest
3. Cerca postgres e scarica il tag 18-alpine

Passo 2: Crea le cartelle condivise

Crea le seguenti cartelle in File Station (o via SSH):

/volume1/docker/xiquil/data
/volume1/docker/xiquil/backups
/volume1/docker/xiquil/db

Passo 3: Crea il progetto Docker Compose

1. In Container Manager, vai su Project
2. Clicca Create
3. Nome: xiquil
4. Percorso: /volume1/docker/xiquil
5. Incolla il contenuto del docker-compose.yml (vedi Docker Compose)
6. Modifica i volumi per usare bind mount:

volumes:
  - /volume1/docker/xiquil/data:/app/data
  - /volume1/docker/xiquil/backups:/app/backups
# Per il DB:
  - /volume1/docker/xiquil/db:/var/lib/postgresql

7. Clicca Create

Passo 4: Configura i permessi

# Via SSH (abilita SSH in Control Panel > Terminal & SNMP)
sudo chown -R 1000:1000 /volume1/docker/xiquil/data
sudo chown -R 1000:1000 /volume1/docker/xiquil/backups
sudo chown -R 999:999 /volume1/docker/xiquil/db

Passo 5: Avvia e accedi

1. Nel progetto xiquil, clicca Start
2. Attendi che entrambi i container siano verdi (circa 1-2 minuti al primo avvio)
3. Apri il browser su https://ip-synology:443

Troubleshooting Synology

Il container si riavvia continuamente Controlla i log in Container Manager > progetto xiquil > Log. La causa piu comune e una password DB non corrispondente.

“Permission denied” nei log Verifica i permessi delle cartelle (Passo 4). Synology usa utenti diversi da Docker: assicurati che PUID/PGID siano impostati correttamente.

Porta 443 occupata DSM stesso o altri pacchetti potrebbero usare la porta 443. Cambia APP_PORT in un valore come 8443 o 9443.