Jellyfin – jak skonfigurować własny serwer multimediów

Jellyfin to darmowy serwer multimediów z otwartym kodem źródłowym, który pozwala zamienić zwykły komputer, NAS lub Raspberry Pi w prywatnego „Netflixa” dla filmów, seriali, muzyki, zdjęć i TV na żywo. W tym poradniku przejdziesz przez wszystko: wybór sprzętu, instalację, konfigurację, dostęp zdalny i optymalizację.

1. Czym jest Jellyfin i dla kogo jest ten poradnik

Jellyfin to oprogramowanie serwerowe (self‑hosted), które organizuje Twoje prywatne multimedia i udostępnia je w sieci lokalnej oraz – jeśli chcesz – przez internet.

Najważniejsze cechy:

open source i 100% darmowy – brak abonamentu i funkcji za paywallem;
wiele typów mediów – filmy, seriale, muzyka, zdjęcia, nagrania TV, teledyski;
wieloplatformowy – działa na Windows, Linux, macOS, NAS-ach i mini‑komputerach;
szeroka dostępność klientów – aplikacje na smartfony, TV, przeglądarki i konsole (często web lub nieoficjalne).

Poradnik jest dla:

użytkowników domowych, którzy chcą mieć własny „Netflix” z domowej biblioteki,
entuzjastów NAS / Raspberry Pi,
osób, które chcą uniezależnić się od firm typu Netflix / Spotify i usług chmurowych.

2. Wymagania – sprzęt i sieć

2.1. Minimalne wymagania sprzętowe

Jellyfin nie potrzebuje wiele do działania – wystarczy prosty serwer, połączenie sieciowe i pliki multimedialne. Im więcej jednoczesnych użytkowników i im wyższa rozdzielczość (4K, HDR), tym mocniejszy CPU i szybszy dysk (SSD na metadane + HDD na media).

Sprzęt, na którym możesz postawić serwer:

typowy komputer PC (stacjonarny lub laptop),
NAS (np. Synology, QNAP, OpenMediaVault),
Raspberry Pi czy inny mikrokomputer,
maszyna wirtualna / kontener (Proxmox, Docker itp.).

Dla szybkiej orientacji w doborze mocy sprzętu, skorzystaj z poniższego zestawienia:

Scenariusz	Zalecany sprzęt
1–2 użytkowników, 1080p (direct play)	starszy desktop lub Intel NUC, dysk SSD na metadane
3–5 użytkowników, 1080p (mieszany direct play/transkodowanie)	4‑rdzeniowy CPU, 8–16 GB RAM, SSD + HDD na media
4K z transkodowaniem	mocny CPU oraz GPU z akceleracją (Intel Quick Sync, NVIDIA NVENC/AMD VCE), szybki SSD

2.2. Sieć i połączenie

Wymagane jest stabilne połączenie sieciowe. Do użytku wyłącznie w LAN wystarczy domowy router i Wi‑Fi/Ethernet. Do dostępu zdalnego przyda się publiczny adres IP lub tunel (VPN, reverse proxy) – szczegóły niżej.

3. Przygotowanie – system, pliki, struktura katalogów

3.1. Wybór systemu

Jellyfin działa na:

Windows (np. domowy PC, mini‑serwer),
Linux (serwer, NAS, WSL2, VM),
macOS (mini‑serwer z Mac mini itp.).

W poradniku pokazujemy konfigurację krok po kroku na Windows (prosty domowy serwer) i Linux (np. Ubuntu) dla bardziej „serwerowego” podejścia.

4. Instalacja Jellyfin na Windows

4.1. Pobranie instalatora

Wejdź na oficjalną stronę projektu Jellyfin (sekcja Pobierz).
Wybierz Jellyfin Media Server dla Windows (nie aplikację kliencką).
Pobierz instalator .exe.

4.2. Instalacja

Uruchom pobrany plik instalacyjny.
Podążaj za kreatorem instalacji – akceptuj licencję, wybierz katalog instalacji.
Po zakończeniu instalacji Jellyfin uruchomi się jako usługa.

Domyślnie panel webowy będzie dostępny pod http://localhost:8096 (na tym samym komputerze) lub pod http://IP_twojego_serwera:8096 (z innych urządzeń w sieci).

5. Instalacja Jellyfin na Linux (np. Ubuntu)

5.1. Instalacja z repozytorium / paczki

Szczegóły różnią się między dystrybucjami, ale ogólny schemat:

Dodaj repozytorium Jellyfin (odpowiednie dla Twojej dystrybucji).
Zainstaluj pakiet jellyfin.
Upewnij się, że usługa jest uruchomiona (np. systemctl status jellyfin).

Alternatywnie pobierz odpowiednią paczkę ze strony Jellyfin (.deb, .tar.gz) i zainstaluj ręcznie.

Podobnie jak na Windows, panel będzie pod http://localhost:8096 lub http://IP_serwera:8096.

6. Pierwsze uruchomienie – kreator konfiguracji

Po zainstalowaniu otwórz przeglądarkę i wejdź pod adres serwera Jellyfin.

Kreator wstępnej konfiguracji przeprowadzi Cię przez kolejne kroki:

Wybór języka interfejsu – wybierz „Polski”, jeśli jest dostępny;
Nazwa serwera – np. „Domowy Media Server” albo „Jellyfin-LivingRoom”;
Utworzenie konta administratora:

login (np. admin albo Twoje imię),
silne hasło (koniecznie, jeśli planujesz dostęp zdalny).

Konfiguracja bibliotek multimediów – dodamy je za chwilę bardziej szczegółowo;
Ustawienia dostępności sieciowej – wstępne opcje dostępu.

Po zakończeniu kreatora trafisz do głównego interfejsu Jellyfin.

7. Organizacja biblioteki multimediów

Klucz do wygodnego korzystania z Jellyfin to dobrze zorganizowana struktura katalogów i poprawne nazewnictwo plików.

7.1. Struktura katalogów – przykład

Na dysku serwera warto stworzyć katalog główny, np. D:\Media (Windows) lub /srv/media (Linux).

W nim utwórz katalogi tematyczne:

Filmy,
Seriale,
Muzyka,
Zdjęcia,
Teledyski,
Nagrania_TV.

Możesz też korzystać z istniejących folderów, byle zachować porządek.

7.2. Dodawanie bibliotek w Jellyfin

W panelu Jellyfin przejdź do ustawień i dodaj źródła mediów:

Kliknij ikonę administratora (zwykle w prawym górnym rogu).
Wybierz „Panel administracyjny” → „Biblioteki” → „Dodaj bibliotekę”.
Ustaw następujące opcje:

typ zawartości – Filmy, Seriale, Muzyka, Zdjęcia itp.;
nazwa biblioteki – np. „Filmy 4K”, „Seriale PL”;
folder zawartości – wskaż wcześniej przygotowany katalog, np. D:\Media\Filmy.

Zapisz zmiany.

Jellyfin rozpocznie indeksowanie i pobieranie metadanych (opisów, okładek, obsady) z internetu, jeśli masz włączone odpowiednie wtyczki.

8. Nazewnictwo plików i metadane

Aby Jellyfin prawidłowo rozpoznawał filmy i seriale, stosuj standardowe konwencje nazewnictwa, np. dla filmów: Tytul.Filmu.2019.1080p.mkv.

Dla seriali używaj struktury sezonów i odcinków, np.: Tytul.Serialu/S01/Tytul.Serialu.S01E01.mkv.

Dobre nazwy ułatwiają pobieranie okładek, opisów i obsady oraz pomagają uniknąć pomyłek przy dopasowaniu tytułów.

W panelu możesz później ręcznie poprawiać tytuły czy plakaty, jeśli coś zostało źle zidentyfikowane.

9. Dostęp do serwera z innych urządzeń

9.1. W sieci lokalnej (LAN)

Na innym urządzeniu (laptop, smartfon, TV):

Podłącz je do tej samej sieci Wi‑Fi/LAN co serwer.
W przeglądarce wpisz adres IP serwera i port 8096, np. http://192.168.0.10:8096.
Zaloguj się swoim loginem i hasłem.
Po zalogowaniu zobaczysz listę bibliotek i rozpoczniesz odtwarzanie.

Zamiast przeglądarki możesz użyć:

aplikacji mobilnych (Android, iOS – oficjalne lub nieoficjalne),
aplikacji na TV (Android TV, Fire TV, niektóre Smart TV),
klienta w Kodi (wtyczka Jellyfin).

9.2. Dostęp zdalny (spoza domu) – ogólnie

Aby oglądać zawartość spoza sieci domowej, skorzystaj z jednej z metod:

przekierowanie portu 8096 (lub innego) z routera na serwer (port forwarding),
reverse proxy z SSL (np. Nginx, Caddy) – lepsze bezpieczeństwo i obsługa HTTPS,
VPN (WireGuard, OpenVPN) – łączysz się do domowej sieci jak lokalny klient.

Jeśli masz publiczne IP, możesz przekierować zewnętrzny port (np. 8443) na wewnętrzny 8096 i dodatkowo skonfigurować HTTPS przez reverse proxy.

10. Transkodowanie i wydajność

10.1. Czym jest transkodowanie?

Transkodowanie to przetwarzanie wideo w locie do innego formatu, rozdzielczości lub bitrate (np. 4K HEVC → 1080p H.264), aby działało na słabszym kliencie i mieściło się w słabszym łączu (np. poza domem). To zadanie intensywnie obciąża CPU i/lub GPU.

10.2. Jak ograniczyć transkodowanie

przygotuj pliki w formatach standardowo obsługiwanych przez Twoje urządzenia (np. H.264 + AAC),
przy zdalnym dostępie ustaw niższy bitrate w aplikacji klienckiej,
jeśli masz GPU z obsługą sprzętowego dekodowania, włącz sprzętowe transkodowanie (sterowniki i wsparcie w systemie wymagane).

11. Jellyfin na NAS, Raspberry Pi, Proxmox i Docker

11.1. NAS / OpenMediaVault

W środowiskach NAS (np. OpenMediaVault) Jellyfin instalujesz jako aplikację z repozytorium/plug‑in lub jako kontener Dockera (oficjalny obraz jellyfin/jellyfin).

Ogólny schemat instalacji na NAS:

Zainstaluj Jellyfin (natywnie lub w kontenerze).
Wskaż katalogi z filmami/serialami na udziałach NAS.
Skonfiguruj dostęp analogicznie jak w sekcjach wyżej.

11.2. Proxmox / kontenery LXC

W Proxmox możesz utworzyć kontener (LXC) lub maszynę wirtualną z Jellyfin.

Przykładowy proces (LXC):

Stwórz nowy kontener z szablonem Debian/Ubuntu.
Przydziel odpowiednią ilość CPU, RAM i przestrzeni dyskowej (np. 1000 GB na filmy 4K).
Skonfiguruj sieć (z reguły DHCP z routera).
Zainstaluj w kontenerze Jellyfin (jak na Linux).
Podmontuj katalogi z filmami (np. z hosta Proxmox).
Uruchom Jellyfin i skonfiguruj biblioteki.

11.3. Docker

Jellyfin możesz wygodnie uruchomić jako kontener Dockera.

Ogólne kroki:

Pobierz oficjalny obraz Jellyfin.
W docker run lub docker-compose.yml ustaw mapowanie portu (np. 8096:8096) oraz wolumeny na media i config (np. /srv/media:/media, /srv/jellyfin/config:/config).
Uruchom kontener – dalsza konfiguracja jak w standardowej instalacji.

12. Bezpieczeństwo i dobre praktyki

silne hasła dla konta administratora i użytkowników,
jeśli wystawiasz Jellyfin do internetu – użyj HTTPS (reverse proxy + certyfikat, np. Let’s Encrypt),
rozważ dostęp przez VPN zamiast bezpośrednio wystawiać usługę do sieci,
regularnie aktualizuj Jellyfin do najnowszej wersji (poprawki bezpieczeństwa i nowe funkcje),
rób backup katalogu konfiguracyjnego (łatwa migracja na inny serwer/maszynę).

13. Tworzenie użytkowników i profili

W panelu administratora możesz definiować:

wiele kont użytkowników (np. dla rodziny),
ograniczenia wiekowe i dostęp do konkretnych bibliotek,
limity transkodowania, urządzeń itp.

Przykłady: konto „Dzieci” – tylko biblioteka „Bajki”, blokada filmów 18+. Konto „Goście” – dostęp tylko z sieci lokalnej, bez prawa do zmiany ustawień.

14. Integracje i funkcje dodatkowe

Jellyfin posiada system wtyczek oraz współpracuje z innymi narzędziami:

integracja z TV na żywo i PVR (jeśli posiadasz tuner TV),
współpraca z aplikacjami do pobierania i zarządzania multimediami (np. Sonarr, Radarr – poprzez wspólne katalogi),
integracje z odtwarzaczami (np. Kodi + wtyczka Jellyfin, webOS, Android TV itp.).

15. Najczęstsze problemy i szybkie rozwiązania

Poniżej znajdziesz typowe kłopoty i sprawdzone, szybkie kroki naprawcze:

nie widzę serwera z innego urządzenia – problem z łącznością sieciową lub zaporą;

sprawdź zaporę systemu (Windows Defender, UFW) i otwarty port 8096,
upewnij się, że serwer i klient są w tej samej sieci (ten sam VLAN/podsieć),
zweryfikuj adres IP serwera i wpisany URL w przeglądarce.

brak napisów lub niewłaściwe napisy – kłopot z plikami lub ustawieniami wtyczek;

umieść plik z napisami w tym samym folderze i o tej samej nazwie co wideo (np. Film.mkv + Film.srt),
sprawdź ustawienia pobierania napisów z internetu (wtyczki i języki),
upewnij się, że format napisów (np. .srt) jest wspierany przez klienta.