Vlastní hosting

Chyby a řešení

Hlášení nebo příznak, jeho příčina a řešení.

v1.0.0 EN

Chyby a řešení

Docker is not installed. Install it (https://docs.docker.com/engine/install/) or re-run with --auto to install automatically.

Příčina: Na tomto počítači chybí Docker.

Řešení:

  1. Nainstalujte Docker Engine (Linux) nebo Docker Desktop (macOS, Windows).
  2. Spusťte instalátor znovu.

Docker did not start within 60 s. Start it manually and re-run.

Příčina: Služba Docker se včas nespustila.

Řešení:

  1. Spusťte Docker (na Linuxu: sudo systemctl start docker).
  2. Ověřte, že funguje docker info, a spusťte instalátor znovu.

Docker Desktop did not start within 120 s. Open it manually and re-run.

Příčina: Docker Desktop na macOS neběží.

Řešení:

  1. Otevřete Docker Desktop a počkejte, až engine běží.
  2. Spusťte instalátor znovu.

Homebrew is required to install Docker on macOS. Install it first: https://brew.sh

Příčina: Automatická instalace na macOS instaluje Docker Desktop přes Homebrew.

Řešení:

  1. Nainstalujte Homebrew z https://brew.sh nebo si sami nainstalujte Docker Desktop.
  2. Spusťte instalátor znovu.

Docker requires sudo on this session. Log out and back in, then re-run.

Příčina: Váš uživatel byl právě přidán do skupiny docker a aktuální relace o tom neví. Stejná příčina vyvolá permission denied na socketu Dockeru.

Řešení:

  1. Pokud skupina chybí, spusťte sudo usermod -aG docker $USER.
  2. Odhlaste se a znovu přihlaste.
  3. Spusťte instalátor znovu.

Unsupported Linux distribution. Install Docker manually: https://docs.docker.com/engine/install/

Příčina: Instalátor neumí na této distribuci Linuxu nainstalovat Docker.

Řešení:

  1. Nainstalujte Docker Engine a Compose plugin podle dokumentace Dockeru.
  2. Spusťte instalátor znovu.

Docker Desktop did not become ready within 120 seconds.

Příčina: Na Windows neběží engine Dockeru. Typické důvody: služba com.docker.service je zastavená, chybí WSL2, je vypnutá virtualizace v BIOSu, nebo je Docker Desktop přepnutý na Windows kontejnery.

Řešení:

  1. Pokud byl Docker Desktop právě nainstalován, restartujte počítač a zkontrolujte ikonu Docker Desktop v oznamovací oblasti.
  2. Ověřte, že je nainstalováno WSL2 (wsl --status), v BIOSu je zapnutá virtualizace a Docker Desktop používá Linux kontejnery.
  3. Ověřte, že funguje docker ps, a spusťte instalátor znovu.

Container exits with code 137, or Docker Desktop becomes very slow

Příčina: Kontejneru došla paměť a byl ukončen.

Řešení:

  1. Přidělte Dockeru alespoň 16 GB paměti (Docker Desktop → Settings → Resources; na Windows hodnota memory v .wslconfig).
  2. Zavřete další náročné programy a restartujte příkazem docker compose restart.

Failed to load Docker image — archive may be corrupt (or docker load stops with a write error)

Příčina: Disk je plný, nebo se soubor balíčku při kopírování poškodil.

Řešení:

  1. Uvolněte místo na disku (je potřeba alespoň 50 GB volného místa).
  2. Pokud byl disk v pořádku, zkopírujte balíček znovu a spusťte instalátor znovu.

Port 3333 is already in use on this host.

Příčina: Port používá jiný program. Automatický instalátor si vybere volný port sám.

Řešení:

  1. Spusťte automatický instalátor, nebo nastavte jiný port v AITM_PORT v souboru docker/.env.
  2. Restartujte příkazem docker compose up -d.

Package authenticity could NOT be verified (no network access to www.aitm.cz ...)

Příčina: Firemní proxy nebo firewall blokuje aitm.cz a license.aitm.cz.

Řešení:

  1. Požádejte správce sítě o povolení aitm.cz a license.aitm.cz.
  2. Spusťte instalátor znovu.

Checksum mismatch for ... / Signature verification FAILED for checksums-v...

Příčina: Balíček je poškozený nebo neúplný.

Řešení:

  1. Stáhněte balíček znovu.
  2. Rozbalte ho do nové složky a spusťte instalátor znovu.

Package version X is older than deployed version Y. Refusing to downgrade.

Příčina: Instalátor instaluje jen stejnou nebo novější verzi, než která běží.

Řešení:

  1. Stáhněte nejnovější verzi.
  2. Spusťte její instalátor.

A staged update is already in progress ...

Příčina: Předchozí aktualizace byla zahájena a nebyla dokončena.

Řešení:

  1. Dokončete ji spuštěním cutover-docker.sh (Windows: cutover-docker.ps1).
  2. Nebo ji zrušte s --abort (Windows: -Abort) a aktualizaci spusťte znovu.

Health check timed out — containers may still be starting. Check: docker compose ps

Příčina: První start trvá minutu nebo dvě; do připravenosti kontejner ukazuje starting nebo unhealthy.

Řešení:

  1. Ve složce docker spusťte docker compose ps a chvíli počkejte.
  2. Pokud zůstane unhealthy, přečtěte si docker compose logs -f.

HTTP 423 when opening AITM

Příčina: Očekávané chování: AITM je zamčený, dokud není aktivována licence nebo zkušební verze.

Řešení:

  1. Otevřete Nastavení → Licence.
  2. Aktivujte klíč nebo spusťte 7denní zkušební verzi.

License activation fails, or the trial says the device is already activated

Příčina: Licence je již použita na maximálním počtu zařízení, nebo toto zařízení již zkušební verzi mělo.

Řešení:

  1. Přihlaste se ke svému účtu na aitm.cz a zkontrolujte aktivace své licence.
  2. Pokud to nepomůže, kontaktujte podporu.

Logy a podpora

Instalátor vypíše cestu ke svému logu (install_<čas>.log vedle skriptů). Běžící aplikace zapisuje do docker compose logs. Pokud problém nevyřešíte, kontaktujte nás a přiložte log instalátoru.