====== QNAP - DOCKER - Instalace Immich ======
//Immich v1.141.1, TS-253Be, QTS 5.2.6.3229//

Docker Compose je doporučená metoda pro Immich.\\
Pro připojení ke QNAP budete potřebovat [[https://www.putty.org]] a v QNAP povolené připojení SSH.

Připojte se pomocí PUTTY

===== Krok 1 - Stáhněte si požadované soubory =====
Vytvořte adresář dle vlastního výběru\\
//Předpokládám, že data kam se ukládají "kontejnery" je sdílený adresář "/share/Container"//
<code>
mkdir /share/Container/Immich
cd /share/Container/Immich
</code>

Stáhněte docker-compose.yml a example.env spuštěním následujících příkazů:\\
<code>
wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
</code>
Můžete si je stáhnout i pomocí vašeho prohlížeče a následně nakopírovat do adresáře /Immich\\
Musíte ale přejmenovat example.env ---> .env

===== Krok 2 - Upravte soubor.env  =====
Výchozí obsah souboru 
<code>
# You can find documentation for all the supported env variables at https://immich.app/docs/install/environment-variables

# The location where your uploaded files are stored
UPLOAD_LOCATION=./library

# The location where your database files are stored. Network shares are not supported for the database
DB_DATA_LOCATION=./postgres

# To set a timezone, uncomment the next line and change Etc/UTC to a TZ identifier from this list: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
# TZ=Etc/UTC

# The Immich version to use. You can pin this to a specific version like "v1.71.0"
IMMICH_VERSION=release

# Connection secret for postgres. You should change it to a random password
# Please use only the characters `A-Za-z0-9`, without special characters or spaces
DB_PASSWORD=postgres

# The values below this line do not need to be changed
###################################################################################
DB_USERNAME=postgres
DB_DATABASE_NAME=immich
</code>
Vše co změníte proti výchozímu, musíte poté dodržet v dalším nastavení !!!
  *  Nastavte UPLOAD_LOCATION preferovaným umístěním pro ukládání záloh. Mělo by se jednat o nový adresář na serveru s dostatkem volného místa.
  *  Zvažte změnu DB_PASSWORD na vlastní hodnotu. Postgres není veřejně dostupný, takže toto heslo se používá pouze pro lokální ověřování. Abyste se vyhnuli problémům s parsováním této hodnoty v Dockeru, je nejlepší použít pouze znaky A-Za-z0-9. Pro tento účel je k dispozici šikovný nástroj pwgen.
  *  Nastavte časové pásmo odkomentováním řádku TZ=. (Europe/Prague)
  * V případě potřeby vyplňte informace o vlastní databázi.
  * POZOR !!! Pokud změníte IMMICH_VERSION na nějaký release - před UPGRADE musíte VŽDY opět editovat tento soubor.
===== Krok 3 - Spusťte kontejner =====
<code>
docker compose up -d
</code>
Vyčkejte až vše doběhne a můžete postupovat dále - trošku to trvá ....

===== Kroky po instalaci =====
Prvním uživatelem, který se zaregistruje, bude uživatel admin. Admin uživatel bude moci přidat další uživatele do aplikace.

Přejděte do webové aplikace na adrese [[http://<machine-ip-address>:2283]] a klikněte na tlačítko Začínáme

Další kroky najdete na stránkách [[https://immich.app/docs/install/post-install/]] 

===== Ruční upgrade =====

Jednou za čas je potřeba upgrade a pokud si nevytvoříte automatický, zde je "ruční" postup.\\
**POZOR !!!** určitě máte více kontejnerů, musíte být vždy ve správném adresáři, aby se spustil správný docker-compose.yml

Po vydání nové verze Immichu byste si měli přečíst poznámky k vydání a zohlednit všechny uvedené závažné změny (jak je uvedeno výše).\\ 
Pokud ve svém souboru .env použijete **IMMICH_VERSION**, bude nutné jej aktualizovat na nejnovější nebo požadovanou verzi. Poté lze aplikaci upgradovat a restartovat pomocí následujících příkazů, které se spustí v adresáři se souborem docker-compose.yml\\
**Já pro jistotu Immich zastavím před UPGRADE, ale netuším zda je to nutné ...**
<code>
cd /share/Container/Immich

docker compose pull && docker compose up -d
</code>

Až si ověříte, zda je Immich plně funkční, lze staré kontejnery odstranit a uvolnit tím místo ...\\
pomocí následujícího příkazu:\\
**POZOR !!!** určitě máte více kontejnerů, musíte být vždy ve správném adresáři
<code>
cd /share/Container/Immich

docker image prune
</code>