Table of Contents

Immich - príručka pre začiatočníkov

Immich je self-hosted platforma na správu fotografií a videí – alternatíva ku Google Fotkám zameraná na súkromie. Ponúka automatické zálohovanie z mobilných zariadení, rozpoznávanie tvárí, inteligentné vyhľadávanie a zdieľané albumy. Všetko beží na vašom serveri cez Docker Compose, takže máte nad dátami plnú kontrolu.


Krok 1 – Overte, že Immich funguje

IP adresa a heslo root vášho servera sú uvedené na stránke Server Details v klientskom paneli. Immich po štarte servera už beží. Otvorte prehliadač a prejdite na:

http://your.server.ip:2283

Mali by ste vidieť registračnú stránku Immich. Ak sa stránka nenačíta, počkajte 1-2 minúty, kým sa spustia všetky kontajnery.

Pri prvom prístupe vyplňte formulár a vytvorte účet administrátora:

  • Email – vaša e-mailová adresa (slúži ako prihlasovacie meno)
  • Password – zvoľte silné heslo
  • First Name a Last Name

Kliknite na Sign Up a vytvorte účet. Po registrácii sa registračná stránka vypne – ďalších používateľov môže vytvárať len administrátor v paneli Administration.

Ak ste server umiestnili za router VyOS v privátnej sieti, buď sa pripojte cez VPN a k Immich pristupujte cez privátnu IP servera (odporúčané pre osobnú službu), alebo nastavte presmerovanie portov (port 22 pre SSH, port 2283 pre webové rozhranie Immich, porty 80/443, ak nastavíte doménu s SSL).


Krok 2 – Inštalácia mobilnej aplikácie (voliteľné)

Immich má mobilné aplikácie na automatické zálohovanie fotografií a videí:

  • iOS – stiahnite Immich z App Store
  • Android – stiahnite Immich z Google Play alebo F-Droid

V aplikácii zadajte URL servera a prihláste sa vytvoreným účtom:

http://your.server.ip:2283

Povoliť Background Backup v nastaveniach aplikácie na automatické nahrávanie nových fotografií a videí.


Krok 3 – Nastavenie domény a SSL (voliteľné)

Prístup k Immich cez vlastnú doménu s HTTPS:

  1. Vytvorte A záznam v nastaveniach DNS, ktorý nasmeruje vašu doménu na IP servera
  2. Počkajte na rozšírenie DNS (zvyčajne niekoľko minút)
  3. Pripojte sa cez SSH a nastavte Nginx ako reverznú proxy s certifikátom Let’s Encrypt:
ssh root@your.server.ip
apt update && apt install -y nginx certbot python3-certbot-nginx

cat > /etc/nginx/sites-available/immich << 'EOF'
server {
    listen 80;
    server_name your-domain.com;
    client_max_body_size 50000M;

    location / {
        proxy_pass http://127.0.0.1:2283;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }
}
EOF

ln -s /etc/nginx/sites-available/immich /etc/nginx/sites-enabled/
rm -f /etc/nginx/sites-enabled/default
nginx -t && systemctl reload nginx

certbot --nginx -d your-domain.com

Nahraďte your-domain.com svojou skutočnou doménou. Certbot nastaví SSL a automatickú obnovu. Direktíva client_max_body_size umožňuje nahrávať veľké videá. Po nastavení zmeňte URL servera v mobilnej aplikácii na https://your-domain.com.


Po inštalácii

Fail2Ban – ochrana proti útokom hrubou silou

Váš server obsahuje Fail2Ban predkonfigurovaný na ochranu SSH proti útokom hrubou silou.

Pravidlo Max. počet pokusov Doba blokovania
SSH5 neúspešných prihlásení10 minút

Užitočné príkazy:

# Check banned IPs
fail2ban-client status sshd

# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4

Ak sa omylom zablokujete, pripojte sa cez konzolu VNC v klientskom paneli a odblokujte svoju IP.

Správa úložiska

Fotografie a videá sú uložené v /opt/immich/upload/. Bežná fotografia z telefónu má 3-5 MB; videá sú oveľa väčšie. Immich tiež generuje náhľady a ML embeddingy (~20 % navyše). Kontrola využitia disku:

df -h /
du -sh /opt/immich/upload/

Správa služieb

Immich beží ako služba systemd cez Docker Compose:

# Check container status
cd /opt/immich && docker compose ps

# View logs
cd /opt/immich && docker compose logs -f

# Restart Immich
systemctl restart immich

Aktualizácie

Aktualizácia Immich na najnovšiu verziu:

cd /opt/immich
curl -fsSL https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml -o docker-compose.yml
docker compose pull
docker compose down && docker compose up -d

Vždy skontrolujte poznámky k vydaniu kvôli prípadným nekompatibilným zmenám.

Zálohy

Zálohujte dve veci: priečinok s nahratými súbormi a databázu:

# Database backup
docker exec -t immich_postgres pg_dumpall -c -U postgres > /opt/immich/db_backup.sql

# Database restore (if needed)
cat /opt/immich/db_backup.sql | docker exec -i immich_postgres psql -U postgres

Zahrnutý softvér

Komponent Verzia
Ubuntu24.04 LTS
DockerNajnovšia
ImmichNajnovšia
PostgreSQL14 (Docker)
Valkey (Redis)9 (Docker)
Fail2Ban1.0

Riešenie problémov

Problém Riešenie
Webové rozhranie sa po prvom štarte nenačítava Počkajte 1-2 minúty na spustenie kontajnerov. Kontrola: cd /opt/immich && docker compose ps
Kontajnery sa neustále reštartujú Kontrola logov: cd /opt/immich && docker compose logs --tail 50. Overte, že máte aspoň 4 GB RAM
Mobilná aplikácia sa nemôže pripojiť Overte, že URL servera obsahuje port: http://your.server.ip:2283
Nedostatok miesta na disku Vyčistite cache Dockera: docker system prune -a. Zvážte zväčšenie disku v klientskom paneli
Zablokované službou Fail2Ban Odblokujte svoju IP cez konzolu VNC v klientskom paneli
Zabudnuté heslo root Obnovte ho cez konzolu VNC v klientskom paneli