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:
- Vytvorte A záznam v nastaveniach DNS, ktorý nasmeruje vašu doménu na IP servera
- Počkajte na rozšírenie DNS (zvyčajne niekoľko minút)
- 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 |
|---|---|---|
| SSH | 5 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 |
|---|---|
| Ubuntu | 24.04 LTS |
| Docker | Najnovšia |
| Immich | Najnovšia |
| PostgreSQL | 14 (Docker) |
| Valkey (Redis) | 9 (Docker) |
| Fail2Ban | 1.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 |