Self-hosted

Docker Compose

Avvia l’edizione open source di FoxDesk con Docker Compose: applicazione, MariaDB e attività in background dall’immagine pubblicata.

Self-hosted

Queste istruzioni riguardano esclusivamente l’edizione open source di FoxDesk installata sulla tua infrastruttura.

Usi FoxDesk Cloud?

I requisiti relativi a server, PHP, database, cron, backup e aggiornamenti indicati in questa pagina non si applicano a FoxDesk Cloud.

Prova FoxDesk Cloud

Che cosa avvia Docker Compose

Il repository di FoxDesk contiene un file docker-compose.yml con tre servizi:

Servizio A cosa serve
app Server web con PHP 8.2 e Apache. Per impostazione predefinita pubblica la porta 8080 su 127.0.0.1.
cron Esegue ogni minuto le attività in background: ricezione e-mail, ticket ricorrenti, promemoria e report pianificati.
db MariaDB 11. Non è raggiungibile fuori dalla rete Compose.

I file dell’applicazione, config.php, gli allegati, l’archivio, i backup e il database si trovano in volumi con nome e restano disponibili dopo riavvii e aggiornamenti dell’immagine.

Avvio con l’immagine pubblicata

Ti serve Docker Engine con il plugin Compose (docker compose).

git clone https://github.com/lukashanes/foxdesk.git
cd foxdesk
cp .env.example .env

In .env imposta DB_PASSWORD e DB_ROOT_PASSWORD. Senza questi valori Compose non parte. Puoi generarne uno con openssl rand -hex 24.

Ogni versione viene pubblicata come immagine per amd64 e arm64 su GitHub Container Registry. Indica la versione in .env e avvia senza build locale:

echo "FOXDESK_IMAGE=ghcr.io/lukashanes/foxdesk:X.Y.Z" >> .env
docker compose pull app cron
docker compose up -d --no-build
docker compose ps

Sostituisci X.Y.Z con la versione attuale indicata nell’elenco delle versioni. Indica una versione precisa invece di latest, così un riavvio non cambia versione in modo imprevisto. app e db devono risultare healthy.

Per costruire l’immagine dal codice sorgente, ometti la riga FOXDESK_IMAGE ed esegui:

docker compose up -d --build

Esegui l’installazione guidata

Apri http://localhost:8080/install.php e completa i due passaggi. Nel passaggio del database inserisci:

Campo Valore
Host del database db
Porta 3306
Nome del database DB_NAME da .env (predefinito foxdesk)
Utente DB_USER da .env (predefinito foxdesk)
Password DB_PASSWORD da .env

La procedura crea lo schema del database e scrive config.php in un volume dedicato. Salva anche l’indirizzo usato come URL dell’applicazione. Se FoxDesk sarà dietro un reverse proxy, esegui l’installazione dall’indirizzo HTTPS pubblico.

Metti HTTPS davanti all’applicazione

FoxDesk reindirizza HTTP a HTTPS per tutti i nomi host tranne localhost e 127.0.0.1. Un’installazione reale richiede quindi un reverse proxy TLS davanti al servizio app. Lascia la porta pubblicata su 127.0.0.1, così solo il proxy raggiunge il container. Esempio con Caddy sull’host:

helpdesk.example.com {
    reverse_proxy 127.0.0.1:8080
}

Aggiornamenti e backup

Installa le nuove versioni di FoxDesk con l’aggiornamento integrato in Admin > Settings > System. Prima salva file e database e consente il ripristino con un clic. Per portare l’immagine a una versione più recente, cambia la versione in FOXDESK_IMAGE ed esegui gli stessi comandi pull e up -d --no-build. Il container salva database e file prima di aggiornarli.

I backup integrati non includono allegati e archivio. La guida Docker completa su GitHub (in inglese) descrive backup completi, ripristino, Traefik e tutte le variabili di configurazione.