Docker Compose
Spusťte open-source verzi FoxDesku přes Docker Compose: aplikaci, MariaDB a úlohy na pozadí z hotového obrazu.
Tyto pokyny platí pouze pro open-source verzi FoxDesku, kterou provozujete na vlastní infrastruktuře.
Požadavky na server, PHP, databázi, cron, zálohy ani aktualizace z této stránky se na FoxDesk Cloud nevztahují.
Vyzkoušet FoxDesk CloudCo Docker Compose spustí
Repozitář FoxDesku obsahuje soubor docker-compose.yml se třemi službami:
| Služba | K čemu slouží |
|---|---|
app |
Webový server s PHP 8.2 a Apache. Ve výchozím nastavení zveřejňuje port 8080 na 127.0.0.1. |
cron |
Jednou za minutu spouští úlohy na pozadí: příjem e-mailů, opakované tikety, připomínky a plánované reporty. |
db |
MariaDB 11. Mimo síť Compose není dostupná. |
Soubory aplikace, config.php, přílohy, úložiště, zálohy a databáze jsou v pojmenovaných svazcích, takže přežijí restart kontejnerů i přechod na nový obraz.
Spuštění z hotového obrazu
Potřebujete Docker Engine s pluginem Compose (docker compose).
git clone https://github.com/lukashanes/foxdesk.git
cd foxdesk
cp .env.example .env
V souboru .env nastavte DB_PASSWORD a DB_ROOT_PASSWORD. Bez nich se Compose nespustí. Hodnotu vygenerujete třeba příkazem openssl rand -hex 24.
Každé vydání vychází jako obraz pro amd64 i arm64 v GitHub Container Registry. V .env určete verzi a spusťte vše bez místního sestavování:
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
Místo X.Y.Z doplňte aktuální verzi ze seznamu vydání. Používejte konkrétní verzi, ne latest, aby se vydání nezměnilo nečekaně při restartu. Služby app a db mají hlásit healthy.
Pokud chcete obraz sestavit ze zdrojového kódu, vynechte řádek s FOXDESK_IMAGE a spusťte:
docker compose up -d --build
Spuštění instalátoru
Otevřete http://localhost:8080/install.php a projděte dva kroky instalátoru. V kroku s databází zadejte:
| Pole | Hodnota |
|---|---|
| Databázový server | db |
| Port | 3306 |
| Název databáze | DB_NAME z .env (výchozí foxdesk) |
| Uživatel | DB_USER z .env (výchozí foxdesk) |
| Heslo | DB_PASSWORD z .env |
Instalátor vytvoří strukturu databáze a zapíše config.php do vlastního svazku. Uloží také adresu, přes kterou jste ho otevřeli, jako adresu aplikace. Pokud bude FoxDesk za reverzní proxy, spusťte instalátor přes veřejnou adresu s HTTPS.
HTTPS před aplikací
FoxDesk přesměrovává HTTP na HTTPS u všech adres kromě localhost a 127.0.0.1. Ostrý provoz proto potřebuje před službou app reverzní proxy s TLS. Port nechte zveřejněný jen na 127.0.0.1, aby se ke kontejneru dostala pouze proxy. Příklad pro Caddy na stejném serveru:
helpdesk.example.com {
reverse_proxy 127.0.0.1:8080
}
Aktualizace a zálohy
Nová vydání FoxDesku instalujte aktualizací přímo v aplikaci: Admin > Settings > System. Před instalací zazálohuje soubory i databázi a umožní návrat jedním kliknutím. Na novější obraz přejdete změnou verze ve FOXDESK_IMAGE a stejnými příkazy pull a up -d --no-build. Kontejner před přechodem zazálohuje databázi a soubory.
Zálohy z aplikace neobsahují přílohy ani úložiště. Úplné zálohy, obnovu, Traefik a všechny proměnné popisuje podrobný návod k Dockeru na GitHubu (anglicky).
