Unraid

Guida all’installazione di XIQUIL su Unraid usando Docker Compose.

Prerequisiti

• Unraid 6.12+ con Docker abilitato
• Plugin Docker Compose Manager installato (dalla Community Applications)
• Share configurata per Docker (default: /mnt/user/appdata/)

Passo 1: Crea le cartelle

mkdir -p /mnt/user/appdata/xiquil/data
mkdir -p /mnt/user/appdata/xiquil/backups
mkdir -p /mnt/user/appdata/xiquil/db

Passo 2: Crea il file docker-compose.yml

Crea il file in /mnt/user/appdata/xiquil/docker-compose.yml con i bind mount:

services:
  app:
    image: ghcr.io/justvitlab/xiquil:latest
    container_name: xiquil_app
    ports:
      - "8443:8443"
    volumes:
      - /mnt/user/appdata/xiquil/data:/app/data
      - /mnt/user/appdata/xiquil/backups:/app/backups
    environment:
      - ALLOWED_HOSTS=your-unraid-ip
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped

  db:
    image: postgres:18-alpine
    container_name: xiquil_db
    volumes:
      - /mnt/user/appdata/xiquil/db:/var/lib/postgresql
    environment:
      - POSTGRES_DB=xiquil
      - POSTGRES_USER=xiquil_admin
      - POSTGRES_PASSWORD=xiquil_local_db
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U xiquil_admin"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 60s
    restart: unless-stopped

Nota

Sostituisci your-unraid-ip con l’IP del tuo Unraid. Il DB ascolta solo dentro la rete Docker — le credenziali default sono safe per self-hosted. Cambia POSTGRES_PASSWORD se preferisci, DATABASE_URL viene costruito automaticamente.

Passo 3: Avvia dal Docker Compose Manager

1. Vai nel tab Docker
2. In Compose, seleziona il file creato
3. Clicca Compose Up

Oppure dalla console:

cd /mnt/user/appdata/xiquil
docker compose up -d

Passo 4: Accedi

Apri https://your-unraid-ip:8443 nel browser.

Nota

Usiamo la porta 8443 per evitare conflitti con la UI di Unraid che usa la porta 443.

Troubleshooting Unraid

Cache e storage Se usi una cache SSD, i container Docker e i volumi dovrebbero risiedere sulla cache per prestazioni ottimali.

Permessi Unraid di default esegue Docker come root. Se vedi errori di permessi, verifica che le cartelle siano accessibili. PUID/PGID di default (1000) funzionano nella maggior parte dei casi.

Aggiornamento Per aggiornare, ferma i container, fai pull delle nuove immagini e riavvia:

cd /mnt/user/appdata/xiquil
docker compose pull
docker compose up -d