Docker Compose
Avvia l’edizione open source di FoxDesk con Docker Compose: applicazione, MariaDB e attività in background dall’immagine pubblicata.
Queste istruzioni riguardano esclusivamente l’edizione open source di FoxDesk installata sulla tua infrastruttura.
I requisiti relativi a server, PHP, database, cron, backup e aggiornamenti indicati in questa pagina non si applicano a FoxDesk Cloud.
Prova FoxDesk CloudChe 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.
