Homepage (gethomepage.dev) – Kompletny Przewodnik po Najlepszym Dashboardzie dla Self-Hostingu

Homepage to darmowy, open-source’owy dashboard aplikacji, który zrewolucjonizował sposób, w jaki osoby zajmujące się self-hostingiem zarządzają swoją infrastrukturą. Projekt dostępny pod adresem gethomepage.dev zdobył dziesiątki tysięcy gwiazdek na GitHubie i stał się de facto standardem wśród homelabowców, administratorów domowych serwerów oraz entuzjastów Dockera i Kubernetes. W tym przewodniku dowiesz się dokładnie, czym jest Homepage, jak go zainstalować, skonfigurować i w pełni wykorzystać jego możliwości.

Pakiet 3 kursów w jeszcze promocyjnej cenie:

Administracja Serwerami Linux, Bezpieczeństwo Serwerów Linux i Homelab

Naucz się praktycznej administracji serwerami Linux, budowy własnego Homelabu, automatyzacji, monitoringu, backupów oraz zabezpieczania systemów. Możesz dołączyć do wybranego szkolenia lub skorzystać z pakietu 3 kursów w promocyjnej cenie.

Zapisy tylko do 18 czerwca, godz. 23:59

Sprawdź szczegóły: https://asdevops.pl/pakiet

Czym jest Homepage? Definicja i kluczowe cechy

Homepage to w pełni statyczny, szybki i bezpieczny dashboard aplikacji działający jako strona startowa dla wszystkich usług uruchomionych w domowej lub prywatnej sieci. Zamiast zapamiętywać dziesiątki adresów IP i portów, użytkownik otwiera przeglądarkę i widzi jeden przejrzysty panel ze wszystkimi linkami, statusami i statystykami w czasie rzeczywistym.

Projekt wyróżnia się kilkoma fundamentalnymi właściwościami:

W pełni statyczny – generuje strony po stronie serwera bez zależności od zewnętrznych baz danych
Szybki – czas ładowania mierzony w milisekundach dzięki architekturze Next.js
Bezpieczny – działa jako w pełni proxy-owany dashboard, co oznacza, że żadne klucze API ani tokeny nie trafiają do przeglądarki użytkownika
Konfigurowalny przez YAML – całość konfiguracji odbywa się poprzez czytelne pliki YAML
Ponad 100 integracji – natywne widżety dla najpopularniejszych usług self-hostowanych
Automatyczne wykrywanie przez Docker Labels – Homepage może samodzielnie odkrywać uruchomione kontenery
Wielojęzyczny – dostępny w dziesiątkach języków, w tym po polsku

Dlaczego Homepage jest lepszy od alternatyw?

Na rynku dashboardów do self-hostingu funkcjonuje kilka popularnych rozwiązań: Heimdall, Dasherr, Organizr, Flame czy Homarr. Homepage wyróżnia się na tle konkurencji z kilku powodów.

Architektura proxy jako przewaga bezpieczeństwa

Kluczową różnicą jest model proxy. W większości dashboardów widżet komunikuje się z docelowym API bezpośrednio z przeglądarki użytkownika – co oznacza, że klucze API są widoczne w ruchu sieciowym i potencjalnie dostępne przez DevTools. Homepage działa inaczej: wszystkie żądania do zewnętrznych API przechodzą przez serwer Node.js, a przeglądarka otrzymuje wyłącznie przetworzone, bezpieczne dane. Klucze API nigdy nie opuszczają serwera.

Konfiguracja jako kod (Configuration as Code)

Pliki YAML to nie tylko wygoda – to filozofia. Całą konfigurację Homepage można wersjonować w repozytorium Git, backupować jedną komendą, przenosić między serwerami w minuty i traktować jak każdy inny element infrastruktury opisanej kodem. Nie ma klikania po panelach admina, nie ma migrating baz danych – jest jeden katalog z plikami tekstowymi.

Ekosystem widżetów

Na chwilę pisania tego artykułu Homepage obsługuje ponad 150 widżetów serwisowych, obejmujących praktycznie całe spektrum popularnych aplikacji self-hostowanych: od mediów (Jellyfin, Plex, Emby, Navidrome) przez sieci (AdGuard Home, Pi-hole, OPNsense, pfSense, Nginx Proxy Manager), automatyzację (Home Assistant, Homebridge), zarządzanie kontenerami (Portainer, Watchtower), pobieranie (qBittorrent, Transmission, SABnzbd), monitoring (Grafana, Prometheus, Uptime Kuma, Netdata) aż po przechowywanie danych (Nextcloud, Immich, TrueNAS, Synology).

Wymagania systemowe

Homepage jest wyjątkowo lekki. Do jego uruchomienia potrzebujemy:

Docker (zalecana metoda) lub Node.js 18+
Minimalnie 256 MB RAM (w praktyce zużywa znacznie mniej)
Kilkadziesiąt MB miejsca na dysku
Dowolny system operacyjny obsługujący Dockera: Linux, macOS, Windows (WSL2)

Najlepiej sprawdza się na dedykowanym sprzęcie takim jak Raspberry Pi 4/5, miniPC z procesorem Intel N100, lub jako kontener na Proxmoxie, Unraid, TrueNAS Scale.

Instalacja Homepage – krok po kroku

Metoda 1: Docker Compose (zalecana)

Docker Compose to zdecydowanie najpopularniejszy i najłatwiejszy sposób uruchomienia Homepage. Wystarczy stworzyć plik docker-compose.yml:

services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    ports:
      - 3000:3000
    volumes:
      - /path/to/config:/app/config
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      HOMEPAGE_ALLOWED_HOSTS: twój-serwer.local
    restart: unless-stopped

Następnie uruchamiamy:

docker compose up -d

Dashboard będzie dostępny pod adresem http://IP-SERWERA:3000.

Kilka uwag do powyższej konfiguracji:

/path/to/config – zastąp ścieżką do lokalnego katalogu, gdzie będą przechowywane pliki konfiguracyjne
Montowanie /var/run/docker.sock jest opcjonalne, ale pozwala Homepage automatycznie wykrywać inne kontenery
HOMEPAGE_ALLOWED_HOSTS to wymagana zmienna środowiskowa – podaj nazwę hosta lub adres IP, pod którym dostępny będzie dashboard

Uruchomienie jako non-root (zwiększone bezpieczeństwo)

Jeśli zależy ci na lepszym poziomie bezpieczeństwa, Homepage obsługuje uruchamianie jako użytkownik bez uprawnień roota poprzez zmienne PUID i PGID:

services:
  homepage:
    image: ghcr.io/gethomepage/homepage:latest
    container_name: homepage
    ports:
      - 3000:3000
    volumes:
      - /path/to/config:/app/config
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      HOMEPAGE_ALLOWED_HOSTS: twój-serwer.local
      PUID: 1000
      PGID: 1000
    restart: unless-stopped

Przykład:

Metoda 2: Docker Run

Dla tych, którzy preferują jednolinijkowe polecenia:

docker run -p 3000:3000 \
  -e HOMEPAGE_ALLOWED_HOSTS=twój-serwer.local \
  -v /path/to/config:/app/config \
  -v /var/run/docker.sock:/var/run/docker.sock \
  ghcr.io/gethomepage/homepage:latest

Metoda 3: Kubernetes

Homepage posiada pełne wsparcie dla Kubernetes z dedykowanym Helm chartem. Jest to rozwiązanie dla zaawansowanych użytkowników zarządzających klastrem k8s:

helm repo add homepage https://jameswynn.github.io/helm-charts
helm install homepage homepage/homepage

Kubernetes-specific features obejmują automatyczne wykrywanie serwisów przez Ingress annotations oraz widget informacyjny pokazujący stan klastra.

Metoda 4: Unraid

Dla użytkowników Unraid Community Applications, Homepage jest dostępne bezpośrednio w sklepie z aplikacjami. Wystarczy wyszukać „Homepage” i zainstalować jednym kliknięciem.

Metoda 5: Instalacja ze źródeł

Dla programistów i osób chcących rozwijać Homepage:

git clone https://github.com/gethomepage/homepage.git
cd homepage
pnpm install
pnpm dev

Struktura plików konfiguracyjnych

Po pierwszym uruchomieniu, w katalogu konfiguracyjnym pojawia się następująca struktura plików:

config/
├── bookmarks.yaml    # zakładki i linki
├── services.yaml     # serwisy z widżetami
├── widgets.yaml      # widżety informacyjne (góra strony)
├── docker.yaml       # konfiguracja połączeń Docker
├── kubernetes.yaml   # konfiguracja Kubernetes
└── settings.yaml     # ustawienia globalne

Każdy plik ma jasno określoną rolę i jest niezależnie edytowalny. Zmiany są wczytywane przez Homepage na bieżąco – nie trzeba restartować kontenera.

Konfiguracja – jak zbudować swój idealny dashboard

settings.yaml – Ustawienia globalne

Plik settings.yaml kontroluje wygląd i zachowanie całego dashboardu:

title: Mój Homelab
description: Dashboard domowego serwera
startURL: /
theme: dark
color: slate
headerStyle: boxed
layout:
  Media:
    style: row
    columns: 4
  Sieć:
    style: column
  Monitoring:
    style: row
    columns: 3

Dostępne motywy kolorystyczne: slate, gray, zinc, neutral, stone, red, orange, yellow, lime, green, emerald, teal, cyan, sky, blue, indigo, violet, purple, fuchsia, pink, rose.

Tryby wyświetlania: light i dark.

services.yaml – Dodawanie serwisów i widżetów

To najważniejszy plik konfiguracyjny. Definiujemy w nim wszystkie serwisy zgrupowane w kategorie:

- Media:
    - Jellyfin:
        icon: jellyfin.png
        href: http://192.168.1.10:8096
        description: Serwer multimedialny
        widget:
          type: jellyfin
          url: http://192.168.1.10:8096
          key: TWÓJ_KLUCZ_API
          enableNowPlaying: true

    - Navidrome:
        icon: navidrome.png
        href: http://192.168.1.10:4533
        description: Serwer muzyczny
        widget:
          type: navidrome
          url: http://192.168.1.10:4533
          user: admin
          token: TWÓJ_TOKEN
          salt: TWÓJ_SALT

- Sieć:
    - AdGuard Home:
        icon: adguard-home.png
        href: http://192.168.1.1:3000
        description: Blokowanie reklam
        widget:
          type: adguard
          url: http://192.168.1.1:3000
          username: admin
          password: "{{HOMEPAGE_VAR_ADGUARD_PASSWORD}}"

    - Nginx Proxy Manager:
        icon: nginx-proxy-manager.png
        href: http://192.168.1.10:81
        description: Reverse proxy
        widget:
          type: npm
          url: http://192.168.1.10:81
          username: admin@example.com
          password: "{{HOMEPAGE_VAR_NPM_PASSWORD}}"

bookmarks.yaml – Zakładki i linki

- Przydatne narzędzia:
    - GitHub:
        - abbr: GH
          href: https://github.com
    - ChatGPT:
        - abbr: AI
          href: https://chat.openai.com

- Dokumentacja:
    - Homepage Docs:
        - abbr: HP
          href: https://gethomepage.dev

widgets.yaml – Widżety informacyjne

Widżety informacyjne wyświetlają się na górze strony i pokazują ogólny stan systemu:

- resources:
    label: System
    cpu: true
    memory: true
    disk: /
    cputemp: true
    units: metric
    refresh: 3000

- datetime:
    text_size: xl
    format:
      dateStyle: long
      timeStyle: short
      hourCycle: h23
      locale: pl

- search:
    provider: google
    target: _blank

- openweathermap:
    label: Warszawa
    latitude: 52.2297
    longitude: 21.0122
    units: metric
    provider: openweathermap
    apiKey: TWÓJ_KLUCZ_API
    cache: 5

Zarządzanie sekretami i bezpieczeństwo

Homepage oferuje wbudowany mechanizm zarządzania wrażliwymi danymi poprzez zmienne środowiskowe. To krytyczna funkcja z punktu widzenia bezpieczeństwa.

Zmienne środowiskowe w konfiguracji

Zamiast wpisywać hasła i klucze API bezpośrednio w plikach YAML, możemy używać placeholderów:

widget:
  type: sonarr
  url: http://192.168.1.10:8989
  key: "{{HOMEPAGE_VAR_SONARR_KEY}}"

A następnie ustawić prawdziwą wartość jako zmienną środowiskową w docker-compose.yml:

environment:
  HOMEPAGE_VAR_SONARR_KEY: abc123def456

Lub jeszcze lepiej – przez plik .env:

# .env
HOMEPAGE_VAR_SONARR_KEY=abc123def456
HOMEPAGE_VAR_ADGUARD_PASSWORD=TajneHasło123
HOMEPAGE_VAR_NPM_PASSWORD=InneHasło456

Czytanie sekretów z plików (Docker Secrets)

Zmienna HOMEPAGE_FILE_XXX pozwala odczytywać wartości z plików, co jest kompatybilne z Docker Secrets:

environment:
  HOMEPAGE_FILE_SONARR_KEY: /run/secrets/sonarr_key

Integracja z Dockerem – automatyczne wykrywanie kontenerów

Jedną z najbardziej użytecznych funkcji Homepage jest możliwość automatycznego wykrywania kontenerów Docker i generowania dla nich wpisów w dashboardzie bez ręcznej edycji pliku services.yaml.

Konfiguracja docker.yaml

my-docker:
  host: 127.0.0.1
  port: 2375

Lub przez socket:

my-docker:
  socket: /var/run/docker.sock

Docker Labels na kontenerach

Następnie każdemu kontenerowi, który ma być widoczny w Homepage, dodajemy odpowiednie etykiety:

services:
  sonarr:
    image: linuxserver/sonarr
    labels:
      homepage.enable: "true"
      homepage.group: Media
      homepage.name: Sonarr
      homepage.icon: sonarr.png
      homepage.href: http://192.168.1.10:8989
      homepage.description: Zarządzanie serialami
      homepage.widget.type: sonarr
      homepage.widget.url: http://192.168.1.10:8989
      homepage.widget.key: "{{HOMEPAGE_VAR_SONARR_KEY}}"

Dzięki temu konfiguracja każdej usługi jest przechowywana razem z jej definicją w docker-compose.yml, a nie w osobnym pliku. To znacznie upraszcza zarządzanie przy dużej liczbie serwisów.

Widżety serwisowe – przegląd najważniejszych kategorii

Media i rozrywka

Widżety mediów to jedne z najczęściej używanych. Homepage obsługuje:

Jellyfin – pokazuje liczbę aktywnych sesji odtwarzania, aktywnych użytkowników, ilość filmów, seriali i piosenek w bibliotece. Po konfiguracji widżet wyświetla w czasie rzeczywistym, co aktualnie jest odtwarzane.

Plex – podobne informacje co Jellyfin, z integracją Tautulli dla bardziej szczegółowych statystyk odtwarzania.

Navidrome – dla miłośników własnego serwera muzycznego: liczba artystów, albumów i piosenek.

Audiobookshelf – statystyki dla fanów audiobooków i podcastów.

Sieci i bezpieczeństwo

AdGuard Home / Pi-hole – wyświetla procent zablokowanych zapytań DNS, całkowitą liczbę zapytań, oraz status filtrowania. Niezastąpiony widżet dla każdego, kto blokuje reklamy na poziomie DNS.

OPNsense / pfSense – statusy interfejsów sieciowych, aktywne połączenia VPN, ruch sieciowy w czasie rzeczywistym.

Nginx Proxy Manager – liczba aktywnych proxy hostów, certyfikatów SSL i przekierowań.

Cloudflare Tunnels – status tuneli i połączeń.

Tailscale / Headscale – status węzłów sieci VPN.

Pobieranie i *arr stack

qBittorrent / Transmission / Deluge – aktywne torrenty, prędkość pobierania i wysyłania, zajęte miejsce.

SABnzbd / NZBget – statusy kolejek pobierania Usenet.

Sonarr – liczba seriali, odcinków, oczekujące pobierania i aktywność kalendarza.

Radarr – filmy w bibliotece, brakujące filmy, statystyki dysku.

Lidarr / Readarr / Prowlarr – analogiczne widżety dla muzyki, e-booków i zarządzania indeksatorami.

Monitoring i infrastruktura

Uptime Kuma – liczba monitorowanych serwisów, status UP/DOWN, procentowy uptime.

Grafana – bezpośrednie osadzenie paneli Grafana jako iFrame.

Prometheus – metryki bezpośrednio z serwera Prometheus.

Netdata – metryki systemowe z agenta Netdata.

Portainer – liczba działających i zatrzymanych kontenerów, zużycie zasobów.

Watchtower – status automatycznych aktualizacji obrazów Docker.

Przechowywanie danych

Nextcloud – wolne i zajęte miejsce, aktywni użytkownicy, wersja serwera.

Immich – liczba zdjęć i filmów, zajęte miejsce na zdjęcia.

TrueNAS – status dysków, zajęcie puli, temperatura dysków.

Synology DiskStation – analogiczne informacje dla urządzeń Synology.

Smart Home i IoT

Home Assistant – stany encji bezpośrednio z HA, możliwość wyświetlania temperatury, wilgotności czy statusu urządzeń.

Homebridge – status mostu i podłączonych akcesoriów.

ESPHome – status urządzeń ESP32/ESP8266.

Finanse i narzędzia

Ghostfolio – wartość portfela inwestycyjnego.

Firefly III – saldo kont bankowych i budżety.

Wallos – śledzenie subskrypcji i wydatków cyklicznych.

Widżety informacyjne

Oprócz widżetów serwisowych, Homepage oferuje widżety informacyjne wyświetlane na górze strony:

Resources – zużycie CPU, RAM, temperatury procesorów i dysków, zajętość dysków. Najczęściej używany widżet informacyjny.

Date & Time – zegar i data w konfigurowalnym formacie, z obsługą stref czasowych.

Search – wbudowana wyszukiwarka z obsługą Google, DuckDuckGo, Bing, Brave i innych.

OpenWeatherMap / Open-Meteo – aktualna pogoda i prognoza z geolokalizacją.

Stocks – kursy akcji i kryptowalut.

Greeting – spersonalizowane powitanie z imieniem.

Kubernetes – status klastra k8s bezpośrednio na dashboardzie.

Glances – rozbudowane metryki systemowe z agenta Glances.

Personalizacja i wygląd

Motywy i kolory

Homepage oferuje rozbudowany system motywów. Poza trybem jasnym i ciemnym, dostępne jest 20 palet kolorów bazujących na Tailwind CSS. Możesz także definiować niestandardowe kolory tła i akcentów.

Niestandardowy CSS i JavaScript

Dla zaawansowanych użytkowników Homepage pozwala wstrzykiwać własny CSS i JavaScript przez plik konfiguracyjny. Otwiera to drzwi do nieograniczonej personalizacji wyglądu:

# settings.yaml
customCSS: |
  .my-dashboard {
    background: linear-gradient(135deg, #1a1a2e, #16213e);
  }
  
  .service-block {
    border-radius: 16px;
    backdrop-filter: blur(10px);
  }

Ikony serwisów

Homepage automatycznie pobiera ikony z popularnych źródeł:

Dashboard Icons – dedykowane repozytorium ikon dla aplikacji self-hostowanych
Selfh.st Icons – alternatywne źródło ikon
Walkxcode Icons – kolejna popularna kolekcja
Własne ikony – możesz umieścić własne pliki PNG/SVG w katalogu /app/public/icons/

Ikony można też odwoływać się przez prefiks mdi: (Material Design Icons), si: (Simple Icons) lub sh: (Selfh.st):

icon: mdi-server
icon: si-jellyfin
icon: sh-portainer

Układ i grupy

Serwisy organizowane są w grupy, a każda grupa może mieć inny styl wyświetlania:

# settings.yaml
layout:
  Media:
    style: row      # poziomy układ
    columns: 4      # 4 kolumny
  Sieć:
    style: column   # pionowy układ
  Monitoring:
    style: row
    columns: 3
    header: false   # ukryj nagłówek grupy

Homepage vs Alternatywy – Szczegółowe Porównanie

Homepage vs Heimdall

Heimdall to starszy dashboard z podobnymi celami, ale znacznie uboższym ekosystemem widżetów. Heimdall konfiguruje się przez GUI (klikanie po panelu), co jest wygodne dla początkujących, ale trudniejsze do automatyzacji. Homepage wygrywa niemal w każdej kategorii technicznej: więcej widżetów, bezpieczniejsza architektura proxy, lepsza konfiguracja jako kod.

Homepage vs Homarr

Homarr to nowoczesna alternatywa z ładnym GUI do konfiguracji metodą drag-and-drop. Dla osób, które nie lubią YAML, Homarr będzie wygodniejszy. Jednak Homepage ma znacznie więcej widżetów i jest bardziej aktywnie rozwijany przez społeczność.

Homepage vs Flame

Flame to bardzo lekki dashboard z minimalną ilością funkcji. Dobre rozwiązanie dla tych, którzy potrzebują tylko listy linków bez żadnych widżetów ani integracji. Homepage jest wielokrotnie bardziej funkcjonalny.

Homepage vs Dasherr

Dasherr to prosty dashboard oparty na plikach konfiguracyjnych. Podobna filozofia do Homepage, ale znacznie mniejszy ekosystem.

Homepage vs Organizr

Organizr to rozbudowana platforma z uwierzytelnianiem, zarządzaniem użytkownikami i wieloma zaawansowanymi funkcjami. Przeznaczona dla większych środowisk z wieloma użytkownikami. Homepage jest prostszy i szybszy do skonfigurowania dla pojedynczego użytkownika.

Podsumowanie: Homepage to najlepszy wybór dla większości homelabowców, którzy chcą szybko postawić funkcjonalny dashboard z bogatymi integracjami, a jednocześnie cenią bezpieczeństwo i konfigurację jako kod.

Najczęściej zadawane pytania (FAQ)

Czy Homepage jest bezpłatne?

Tak, Homepage jest w pełni bezpłatne i open-source na licencji GPL-3.0. Projekt jest utrzymywany przez społeczność, a wsparcie finansowe można wyrazić przez Open Collective lub Patreon.

Czy Homepage wymaga dostępu do internetu?

Nie. Homepage działa w pełni lokalnie, bez żadnych zewnętrznych zależności. Jedynym wyjątkiem są widżety pogodowe (wymagają API OpenWeatherMap/Open-Meteo) oraz pobieranie ikon (opcjonalne). Sama aplikacja nie wysyła żadnych danych na zewnątrz.

Czy Homepage jest bezpieczne do wystawienia w internecie?

Homepage nie posiada wbudowanego systemu uwierzytelniania. Przed wystawieniem w internecie należy użyć reverse proxy (Nginx Proxy Manager, Traefik, Caddy) z obsługą uwierzytelniania – np. przez Authelia, Authentik lub podstawowe HTTP Auth. Nie zaleca się udostępniania Homepage bez żadnego uwierzytelniania.

Jak często są aktualizacje?

Projekt jest bardzo aktywnie rozwijany. Nowe widżety, poprawki błędów i ulepszenia pojawiają się regularnie, często kilka razy w tygodniu. Śledzenie nowości najłatwiej przez GitHub Releases.

Czy mogę używać Homepage na Raspberry Pi?

Tak. Homepage doskonale działa na Raspberry Pi 3B+, 4 i 5. Obraz Docker jest dostępny dla architektur ARM64 i ARMv7. Zużycie zasobów jest minimalne – zazwyczaj 50-100 MB RAM.

Co zrobić gdy widżet nie wyświetla danych?

Najczęstsze przyczyny problemów z widżetami to: niepoprawny klucz API, błędny adres URL serwisu (używaj adresów dostępnych z sieci kontenera Docker, nie localhost), problemy z siecią Docker (upewnij się, że kontenery są w tej samej sieci), lub brak uprawnień. Logi można podejrzeć przez docker logs homepage.

Czy można mieć wiele instancji Homepage?

Tak. Można uruchomić kilka instancji z różnymi plikami konfiguracyjnymi – np. jedną dla rodziny z prostym interfejsem, drugą dla administratora z pełnymi statystykami.

Zaawansowane przypadki użycia

Homepage jako strona domowa w przeglądarce

Najprostszy przypadek użycia: ustawienie http://IP-SERWERA:3000 jako strony domowej w przeglądarce na komputerze domowym. Każde nowe okno przeglądarki otwiera dashboard z podglądem wszystkich usług.

Integracja z Nginx Proxy Manager i własną domeną

Wygodniejsze rozwiązanie to uruchomienie Homepage pod własną domeną lokalną, np. home.lan lub dashboard.serwer.pl. Konfiguracja w Nginx Proxy Manager:

Dodaj nowy Proxy Host
Domain Name: home.twoja-domena.pl
Forward Hostname: homepage
Forward Port: 3000
Włącz SSL z Let’s Encrypt

Monitorowanie wielu serwerów

Dzięki konfiguracji wielu instancji Docker w docker.yaml, jeden dashboard Homepage może monitorować kontenery na kilku różnych serwerach fizycznych jednocześnie:

# docker.yaml
serwer-główny:
  host: 192.168.1.10
  port: 2375

serwer-backup:
  host: 192.168.1.20
  port: 2375

Homepage w środowisku rodzinnym

Można stworzyć uproszczoną wersję dashboardu dla pozostałych domowników, pokazującą tylko linki do Jellyfin, Navidrome czy innych mediów – bez technicznych widżetów monitoringu.

Backup konfiguracji

Ponieważ cała konfiguracja to pliki tekstowe, backup jest trywialny:

# Backup
tar -czf homepage-backup-$(date +%Y%m%d).tar.gz /path/to/config/

# Restore
tar -xzf homepage-backup-20240101.tar.gz -C /

Jeszcze lepiej – trzymanie konfiguracji w prywatnym repozytorium Git z automatycznym commitem przy każdej zmianie.

Społeczność i wsparcie

GitHub

Główne repozytorium projektu: github.com/gethomepage/homepage. Tu zgłaszamy błędy, proponujemy nowe funkcje i śledzimy rozwój projektu. Na GitHubie projekt zdobył ponad 20 000 gwiazdek – co jasno pokazuje jego popularność w społeczności self-hostingu.

Discord

Aktywna społeczność na serwerze Discord (discord.gg/k4ruYNrudu) to najszybsze miejsce do uzyskania pomocy, wymiany konfiguracji i inspiracji na wygląd dashboardu.

Reddit

Subreddity r/selfhosted i r/homelab regularnie goszczą posty z konfiguracjami Homepage. Szukanie „homepage dashboard” w tych społecznościach to kopalnia inspiracji i gotowych snippetów konfiguracyjnych.

Dokumentacja

Oficjalna dokumentacja na gethomepage.dev jest dobrze utrzymana i zawiera przykłady dla każdego widżetu. Każdy widżet ma swoją stronę z pełną listą opcji konfiguracyjnych.

Podsumowanie – Czy Homepage jest właściwym wyborem dla Ciebie?

Homepage (gethomepage.dev) to w 2026 roku najlepszy dashboard do self-hostingu dla zdecydowanej większości użytkowników. Oto dla kogo jest szczególnie polecany:

Jeśli zarządzasz homelabem z kilkoma lub kilkunastoma usługami – Homepage to oczywisty wybór. Bogaty ekosystem ponad 150 widżetów, architektura bezpieczeństwa z pełnym proxy, konfiguracja przez YAML i automatyczne wykrywanie kontenerów Docker sprawiają, że w ciągu kilku godzin możesz mieć w pełni funkcjonalny, profesjonalnie wyglądający dashboard.

Jeśli cenisz bezpieczeństwo i nie chcesz, by klucze API trafiały do przeglądarki – Homepage to jedyny rozsądny wybór wśród popularnych dashboardów.

Jeśli chcesz traktować konfigurację jako kod, wersjonować ją w Git i automatyzować przez CI/CD – pliki YAML to właściwe podejście.

Jeśli dopiero zaczynasz przygodę z self-hostingiem – Homepage będzie doskonałym centrum dowodzenia, które będzie rosło razem z Twoją infrastrukturą.

Projekt Homepage jest żywym dowodem na to, że oprogramowanie open-source tworzone przez pasjonatów może dorównywać, a nawet przewyższać komercyjne rozwiązania. Aktywna społeczność, szybki rozwój i przemyślana architektura czynią z niego narzędzie, które raz skonfigurowane, służy latami.