Vlastní server

Docker Compose

Spusťte open-source verzi FoxDesku přes Docker Compose: aplikaci, MariaDB a úlohy na pozadí z hotového obrazu.

Vlastní server

Tyto pokyny platí pouze pro open-source verzi FoxDesku, kterou provozujete na vlastní infrastruktuře.

Používáte FoxDesk Cloud?

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 Cloud

Co 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).