Kto stawia więcej niż jedną aplikację na Boxie, prędzej czy później traci orientację, pod jakim adresem stoi n8n, gdzie jest panel Uptime Kuma, a gdzie Grafana klienta. Rozwiązaniem jest jedna strona startowa z listą linków, którą otwierasz zamiast szukać zakładki w przeglądarce. Homepage robi dokładnie to, jako open source dashboard, który stawiasz na własnym Boxie bez bazy danych i bez miesięcznego rachunku. Poniżej krok po kroku, jak postawić Homepage na Saplo.
Dlaczego Homepage zamiast zakładek w przeglądarce
Zakładki w przeglądarce działają, dopóki liczba aplikacji jest mała i wszystkie otwierasz z jednego komputera. Problem zaczyna się, gdy:
- aplikacji przybywa - agencja z kilkoma klientami i kilkoma narzędziami wewnętrznymi (n8n, monitoring, panel CMS) szybko dochodzi do kilkunastu adresów, które trzeba pamiętać albo mieć zapisane,
- z narzędzi korzysta więcej niż jedna osoba - zakładki w prywatnej przeglądarce nie pomogą zespołowi, każdy musi dostać listę adresów osobno, a przy zmianie domeny trzeba ją rozesłać ponownie.
Homepage rozwiązuje to jako pojedynczy kontener Docker na Twoim Boxie: jedna strona z linkami, którą podajesz każdemu w zespole, bez limitu liczby aplikacji i bez żadnej opłaty poza kosztem samego Boxa.
Wymagania
Żeby postawić Homepage na Saplo, potrzebujesz:
- Boxa z uruchomionym Dockerem (silnik włącza go automatycznie przy instalacji z katalogu, wymagane jest nesting w kontenerze, co Saplo ma domyślnie),
- minimum 512 MB RAM wolnego na Boxie i 2 GB miejsca na dysku, czyli wystarczy plan Box S,
- domeny albo subdomeny
*.saploapp.plw cenie każdego planu, pod którą stanie dashboard, - osobnej bazy danych NIE potrzebujesz, Homepage trzyma całą konfigurację w plikach YAML w wolumenie Dockera.
Instalacja krok po kroku
- W panelu Saplo wejdź w Katalog aplikacji i wybierz Homepage (kategoria "Biznes").
- Wskaż Box z minimum 512 MB wolnego RAM, na którym ma stanąć dashboard, oraz domenę albo subdomenę, pod którą będzie działał.
- Zatwierdź instalację. Silnik stawia kontener z oficjalnego obrazu
ghcr.io/gethomepage/homepage, wystawia go wyłącznie na loopback Boxa i podpina pod nginx, który serwuje go pod wskazaną domeną z darmowym SSL. Na zewnątrz wystawiony jest tylko port 443, nie surowy port 3000 kontenera. - Po
docker compose upsilnik dodatkowo sprawdza, czy dashboard faktycznie odpowiada po HTTP na endpoincie/api/healthcheck, bo sam status "kontener działa" nie oznacza, że proces w środku nie wpadł w pętlę restartów chwilę później. - Po zakończeniu instalacji panel Homepage jest dostępny pod wskazaną domeną, zabezpieczony hasłem wygenerowanym automatycznie przy instalacji (zapisanym w pliku SETUP na Boxie).
Pierwsza konfiguracja
Homepage nie ma kreatora ani konta administratora, tylko wbudowaną autoryzację jednym hasłem, włączoną od razu przy instalacji.
- Wejdź pod adres domeny, na przykład
start.saploapp.pl, i zaloguj się hasłem z plikuHOMEPAGE-SETUP.txtna Boxie. - Własne linki do aplikacji dopisujesz ręcznie w pliku
services.yamlw wolumenie konfiguracji, każdy wpis to nazwa, adres i opcjonalna ikona. - Widgety pogody, statusu kontenerów Docker czy statystyk z innych narzędzi konfigurujesz w
widgets.yaml, a zakładki do zewnętrznych stron wbookmarks.yaml. - Wygląd i układ dashboardu (kolory, liczba kolumn, tło) ustawiasz w
settings.yaml. - Integracja z soketem Dockera Boxa jest w Saplo celowo wyłączona, więc Homepage NIE wykrywa automatycznie innych kontenerów, każdą aplikację dopisujesz ręcznie, to samo ograniczenie co przy każdej innej recepturze na Boxie współdzielonym z innymi klientami.
Homepage na Saplo kontra zakładki w przeglądarce
| Zakładki w przeglądarce | Homepage na Saplo | |
|---|---|---|
| Dostęp dla zespołu | osobno dla każdej przeglądarki | jeden wspólny adres z hasłem |
| Widgety i statusy aplikacji | brak | tak, konfigurowalne w YAML |
| Zmiana adresu aplikacji | ręczna aktualizacja u każdego | jedna zmiana w pliku konfiguracji |
| Koszt | brak, ale też brak funkcji | koszt samego Boxa, bez dopłaty za dashboard |
Najczęstsze pytania
Czy Homepage potrzebuje osobnej bazy danych? Nie, cała konfiguracja siedzi w plikach YAML w wolumenie Dockera, silnik Saplo nie stawia do niej żadnego dodatkowego kontenera bazodanowego.
Czy Homepage widzi automatycznie inne aplikacje na Boxie?
Nie, integracja z soketem Dockera hosta jest celowo wyłączona ze względów bezpieczeństwa Boxa współdzielonego z innymi klientami, linki do aplikacji dopisujesz ręcznie w pliku services.yaml.
Jak zmienić hasło do dashboardu?
Edytujesz zmienną HOMEPAGE_AUTH_PASSWORD w opcjach kontenera w panelu Saplo i restartujesz aplikację, domyślne hasło jest losowe i zapisane w pliku HOMEPAGE-SETUP.txt na Boxie.
Czy trzeba samemu instalować Dockera przed postawieniem Homepage? Nie, silnik Saplo instaluje Docker CE automatycznie przy pierwszej instalacji dowolnej aplikacji kontenerowej na danym Boxie.
Jeśli masz na Boxie kilka aplikacji i chcesz mieć do nich jedno miejsce startowe zamiast szukać zakładek, napisz do nas, pomożemy dobrać Box pod Twój zestaw narzędzi.