2. Instalace - Quickstart
Nejrychlejší cesta k běžící aplikaci: Docker s hotovým image z GHCR. Kapitola je technická, určená pro osobu, která systém nasazuje (IT administrátor, hostingový tým). Běžný uživatel ji může přeskočit.
2.1 Kdy to potřebujete
- Chcete mít MyÚčto v provozu za pár minut, bez instalace PHP, Node a databáze na hostiteli.
- Zkoušíte systém na vlastním počítači nebo na testovacím serveru.
- Nasazujete novou instalaci a vybíráte mezi Dockerem a nativním provozem.
2.2 Než začnete
Stačí Git a Docker. Pokud je ještě nemáte:
Windows (přes winget, součást Windows 10/11):
winget install --id Git.Git -e
winget install --id Docker.DockerDesktop -e
winget install --id Microsoft.PowerShell -ePowerShell 7 je povinný, ne doporučený. Windows PowerShell 5.1, který je na Windows pořád výchozí, zapisuje soubory s BOM a nezná část syntaxe, takže by tiše vznikla rozbitá konfigurace. Skript to pozná a raději hned skončí s hláškou. Spouštějte ho příkazem pwsh, ne powershell.
macOS (přes Homebrew):
brew install git
brew install --cask dockerPřípadně stáhněte ručně: Git na git-scm.com/downloads, Docker Desktop na docker.com/products/docker-desktop. Na Linuxu nainstalujte Docker Engine + compose-plugin z balíčkovacího systému distribuce.
Po instalaci Docker Desktopu ho spusťte a počkejte, až naběhne (ikona v liště). Teprve pak fungují příkazy docker ....
2.3 Krok za krokem: spuštění přes Docker
- Stáhněte repozitář a přejděte do něj:
git clone https://github.com/radekhulan/myucto.git myucto
cd myucto- Spusťte instalační skript:
# Linux / macOS
cmd/docker-ghcr.sh
# Windows - v PowerShellu 7 (pwsh), ne ve Windows PowerShellu
pwsh -File .\cmd\docker-ghcr.ps1Skript vygeneruje náhodná hesla a soubor cfg.docker.php, stáhne image z GHCR, nastartuje stack a spustí migrace.
- Otevřete v prohlížeči
http://localhost:8080(plain HTTP, explicitní port:8080). - Dokončete průvodce prvním spuštěním, viz 7. První spuštění.
Jak poznáte, že je hotovo: v prohlížeči naskočí průvodce prvním spuštěním.
2.4 Když něco nejde
| Co vidíte | Proč | Co udělat |
|---|---|---|
| Skript skončí hláškou o verzi PowerShellu | Spouštíte ho ve Windows PowerShellu 5.1. | Spusťte ho přes pwsh. |
Příkazy docker ... selhávají | Docker Desktop ještě nenaběhl. | Spusťte Docker Desktop a počkejte na ikonu v liště. |
Stránka na localhost:8080 se nenačte | Chybí port nebo se používá HTTPS. | Použijte přesně http://localhost:8080. |
2.5 Podrobnosti a pravidla
2.5.1 Kudy dál
Tři možnosti podle prostředí:
| Cesta | Kdy | Detail |
|---|---|---|
| Docker | nové instalace, nejrychlejší | Instalace - Docker |
| Nativní | tradiční hosting (PHP + MariaDB + IIS/Apache) | Instalace - Nativní |
| Po instalaci | co dělat po prvním startu + CLI nástroje | Po instalaci a CLI nástroje |
V produkci pinujte konkrétní verzi image a postavte před stack HTTPS reverse proxy, viz § 3.8 HTTPS / TLS terminace.