SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Keycloak, authentik czy Zitadel na jednym VPS

Porównanie wymagań pamięciowych serwerów SSO na małym VPS. Sprawdź, ile RAM faktycznie zużywa Keycloak, authentik oraz Zitadel i który z nich obsłuży aplikacje bez wsparcia SSO.

Który serwer SSO wybrać na jeden VPS

Keycloak, authentik oraz Zitadel to serwery typu self-hosted single sign-on (SSO), które pojawiają się w każdej dyskusji o ujednoliceniu logowania do wszystkich aplikacji na serwerze. Na pojedynczym, małym VPS nie są one zamienne. authentik stanowi bezpieczny wybór domyślny dla serwera z trzema lub czterema aplikacjami, ponieważ jako jedyny z tej trójki potrafi wyświetlić ekran logowania przed aplikacją, która nie posiada własnego mechanizmu uwierzytelniania. Keycloak jest właściwym rozwiązaniem, gdy każda chroniona aplikacja obsługuje standardowy protokół, a zasoby pamięci pozwalają na uruchomienie maszyny wirtualnej Java (JVM). Zitadel został stworzony z myślą o programistach dostarczających produkt przez API i jest rozwiązaniem, którego nie zaleca się uruchamiać przy mniej niż 4 GB pamięci RAM.

Najpierw wybierz rozwiązanie, a następnie przystąp do instalacji. Po dokonaniu wyboru, praktyczna instalacja authentik na VPS zawiera szczegółowy opis konfiguracji krok po kroku.

Ile pamięci RAM faktycznie wymaga każde z rozwiązań?

Należy zacząć od minimalnych wymagań sprzętowych, ponieważ to one determinują listę kandydatów jeszcze przed analizą funkcji. Poniższe liczby to oficjalne dane publikowane przez twórców projektów, odczytane w październiku 2026 roku. Są to wytyczne producenta, a nie wyniki testów obciążeniowych.

WykresPublished minimum RAM and base container count, October 2026
Dane, na których opiera się ten wykres
[
  {
    "label": "authentik",
    "vendor_min_ram_mb": 2048,
    "base_containers": 3
  },
  {
    "label": "Keycloak",
    "vendor_min_ram_mb": 1250,
    "base_containers": 2
  },
  {
    "label": "Zitadel",
    "vendor_min_ram_mb": 2048,
    "base_containers": 4
  }
]

Strona instalacji authentik za pomocą Docker Compose wymaga "hosta z co najmniej 2 rdzeniami CPU i 2 GB pamięci RAM", co daje 2048 MB. Publikowany plik compose uruchamia 3 kontenery: PostgreSQL, serwer oraz worker. Wartość dla hosta musi pokryć zapotrzebowanie wszystkich trzech elementów, wliczając w to bazę danych.

Keycloak publikuje najbardziej precyzyjne dane w 3. Przewodnik doboru rozmiaru wskazuje, że "podstawowe zużycie pamięci dla Poda, wliczając pamięć podręczną danych Realm oraz 10 000 sesji, wynosi 1250 MB RAM". Te 1250 MB dotyczą serwera Keycloak wraz z pamięciami podręcznymi. Przewodnik traktuje bazę danych oddzielnie, więc PostgreSQL wymaga dodatkowej pamięci ponad tę wartość. Ta sama strona wyjaśnia, dlaczego limit kontenera jest tak istotny: Keycloak rezerwuje 70% limitu pamięci na stertę (heap) i zużywa około 300 MB pamięci poza stertą. Przykład obliczeniowy w przewodniku przekształca bazę 1250 MB w limit pamięci 1360 MB. Przydzielenie kontenerowi 1 GB skutkuje obliczeniem sterty na poziomie około 717 MB, a około 300 MB pamięci poza stertą daje łącznie około 1017 MB. Pozostawia to niemal zerowy margines bezpieczeństwa, podczas gdy bazowa wartość z przewodnika, uwzględniająca pamięci podręczne i 10 000 sesji, wynosi 1250 MB.

Strona projektu Zitadel dotycząca Docker Compose również wymaga 2 GB, czyli tych samych 2048 MB, wymienionych jako warunek wstępny dla całego przewodnika, od szybkiego startu po etapy homelab lub środowiska półprodukcyjne. W celu doboru rozmiaru dla większych wdrożeń należy zapoznać się ze stroną dotyczącą środowisk produkcyjnych. Sam proces Zitadel wymaga "około 512 MB pamięci RAM i może działać przy mniej niż jednym rdzeniu CPU". Baza danych jest najbardziej zasobożernym elementem: "około jeden rdzeń CPU na 100 żądań na sekundę (req/s) oraz 4 GB RAM na rdzeń". Haszowanie haseł wymaga "4 rdzeni CPU dostępnych do tego celu", ponieważ nagły wzrost liczby logowań powoduje skokowe obciążenie procesora. Oficjalny plik compose w wersji v4 uruchamia 4 kontenery przed dodaniem jakichkolwiek dodatków: Traefik jako proxy, API Zitadel, oddzielny kontener interfejsu logowania oraz PostgreSQL. Redis i kolektor OpenTelemetry znajdują się w opcjonalnych profilach compose.

Podsumowując, Keycloak i authentik mieszczą się na serwerze VPS z 4 GB RAM, pozostawiając wolne zasoby dla chronionych aplikacji. Zitadel uruchomi się na 2 GB, ale przy każdym logowaniu będzie rywalizować o pamięć z własną bazą PostgreSQL. Nie zaleca się uruchamiania Zitadel na mniej niż 4 GB RAM, a w przypadku serwera hostującego również inne aplikacje, zalecane jest 8 GB.

Co faktycznie uruchamia się na Twoim serwerze

authentik to PostgreSQL oraz dwie kopie tego samego obrazu: serwer i worker. Serwer obsługuje ruch HTTP i zawiera wbudowany outpost. Worker wykonuje zadania w tle, takie jak synchronizacja katalogów czy wysyłka wiadomości e-mail. Opublikowana instalacja jest krótka.

wget https://docs.goauthentik.io/compose.yml
echo "PG_PASS=$(openssl rand -base64 36 | tr -d '\n')" >> .env
echo "AUTHENTIK_SECRET_KEY=$(openssl rand -base64 60 | tr -d '\n')" >> .env
docker compose pull
docker compose up -d

Serwer udostępnia porty 9000 oraz 9443. Pierwsze połączenie z portem 9000 uruchamia proces wstępnej konfiguracji, w którym ustawia się hasło dla domyślnego użytkownika akadmin. Przed udostępnieniem tego portu w Internecie należy umieścić przed nim reverse proxy z poprawnym certyfikatem.

Keycloak to jeden proces oraz dostarczona przez użytkownika baza danych. Szybki start opiera się na pojedynczym kontenerze.

docker run -p 127.0.0.1:8080:8080 \
  -e KC_BOOTSTRAP_ADMIN_USERNAME=admin \
  -e KC_BOOTSTRAP_ADMIN_PASSWORD=admin \
  quay.io/keycloak/keycloak:26.8.1 start-dev

start-dev służy do wstępnego zapoznania się z rozwiązaniem. Uruchamia się z lokalną bazą danych typu development i bez TLS (transport layer security), więc kontener uruchomiony w ten sposób i później usunięty spowoduje utratę całego realm. Wdrożenie produkcyjne wymaga użycia start, z pełnowartościową bazą PostgreSQL poprzez KC_DB oraz publiczną nazwą hosta poprzez KC_HOSTNAME. Dokumentacja produkcyjna Keycloak wskazuje również, że cała komunikacja z serwerem i do serwera wymaga bezpiecznego kanału, więc HTTPS nie jest tam opcjonalny.

Zitadel to opisany powyżej stos czterech kontenerów.

mkdir zitadel-compose && cd zitadel-compose
curl -fsSLO https://raw.githubusercontent.com/zitadel/zitadel/main/deploy/compose/docker-compose.yml
curl -fsSLO https://raw.githubusercontent.com/zitadel/zitadel/main/deploy/compose/.env.example
cp .env.example .env
docker compose up -d --wait

Przed pierwszym uruchomieniem ustaw ZITADEL_MASTERKEY w .env. Jest to 32-znakowy klucz, którego Zitadel używa do szyfrowania sekretów w bazie danych; jego utrata oznacza brak dostępu do tych danych. Jeśli dopiero zaczynasz pracę z takimi stosami, podstawy Docker Compose dla VPS omawiają wybory dotyczące wolumenów i polityki restartu, które decydują o tym, czy Twój dostawca tożsamości przetrwa restart systemu.

Jakie protokoły obsługuje każde z rozwiązań?

Wszystkie trzy obsługują OpenID Connect (OIDC), warstwę logowania opartą na OAuth 2.0 wykorzystywaną przez nowoczesne aplikacje, oraz SAML 2.0 (security assertion markup language), starszy standard wciąż stosowany w oprogramowaniu klasy enterprise. Różnica pojawia się w przypadku LDAP (lightweight directory access protocol), gdzie jedno określenie odnosi się do dwóch odmiennych zadań.

Odczyt z LDAP oznacza, że serwer SSO weryfikuje hasła w oparciu o istniejący katalog użytkowników. Keycloak realizuje to poprzez federację użytkowników. Zitadel również oferuje taką funkcjonalność: dokumentacja opisuje sposób „podłączenia serwera LDAP jako dostawcy tożsamości w ZITADEL”.

Udostępnianie LDAP oznacza, że aplikacja obsługująca wyłącznie LDAP może uwierzytelnić się (bind) do serwera SSO tak, jakby był on katalogiem. Tylko authentik oferuje taką możliwość. Jego dostawca LDAP sprawia, że „wszyscy użytkownicy i grupy w bazie danych authentik są przeszukiwalni przez katalog LDAP” za pośrednictwem dedykowanego outpostu LDAP, z dostępnym LDAPS na porcie 636. Domyślnie użytkownik może wyszukiwać tylko własne dane i grupy, dlatego konto serwisowe, którego używa aplikacja do bindowania, wymaga uprawnienia „Search full LDAP directory”, aby widzieć wszystkich użytkowników. Dokumentacja obejmuje wyłącznie operacje bind i search, nie opisując operacji zapisu, dlatego należy traktować to rozwiązanie jako katalog tylko do odczytu. Kod jednorazowy jest dołączany do hasła po średniku, jak w password;123456, a uwierzytelnianie SMS nie jest wspierane podczas operacji bind.

Jeśli jedna z aplikacji na liście obsługuje wyłącznie LDAP, porównanie kończy się w tym miejscu. Keycloak i Zitadel nie obsłużą takiego zapytania bind, więc konieczne byłoby uruchomienie drugiego katalogu obok nich i utrzymywanie synchronizacji dwóch list użytkowników.

Co z aplikacjami, które w ogóle nie posiadają logowania?

Rozwiązaniem jest forward auth, z czym serwery self-hosted stykają się nieustannie. Reverse proxy pyta serwer SSO, czy żądanie jest dozwolone, zanim przekaże je do backendu. Aplikacja znajdująca się za proxy nie otrzymuje żadnych informacji o SSO. Odbiera ona żądania już zweryfikowane przez proxy, zazwyczaj z nazwą użytkownika przekazaną w nagłówku.

Dostawca proxy w authentik obsługuje ten scenariusz w trzech udokumentowanych trybach. Tryb "Proxy" sprawia, że outpost authentik samodzielnie przekazuje ruch do aplikacji nadrzędnej. "Forward auth (single application)" pozostawia obsługę ruchu w istniejącym reverse proxy, wykorzystując authentik wyłącznie do weryfikacji uwierzytelnienia. "Forward auth (domain level)" chroni wszystkie aplikacje w ramach jednej domeny nadrzędnej za pomocą pojedynczego dostawcy. Tryb domenowy jest najwygodniejszy, ale posiada udokumentowane ograniczenie: "nie pozwala na egzekwowanie różnych reguł autoryzacji na poziomie aplikacji dla każdej z chronionych usług", więc wszystkie aplikacje w tej domenie współdzielą jeden zestaw polityk.

Keycloak nie posiada takich funkcji. Jego towarzyszące proxy, Keycloak Gatekeeper, zostało przemianowane na Louketo Proxy, osiągnęło status end of life w listopadzie 2020 roku i zostało zarchiwizowane na GitHubie w grudniu 2020 roku. Aby zabezpieczyć aplikację bez wsparcia OIDC, należy uruchomić przed nią osobny komponent, zazwyczaj oauth2-proxy, wskazujący na klienta Keycloak. Zitadel również nie posiada własnego trybu forward auth, więc rozwiązaniem jest ten sam dodatkowy komponent, który trzeba zainstalować, monitorować i aktualizować.

Ten dodatkowy krok to moment, w którym konfiguracja reverse proxy przestaje być prosta, dlatego warto przeczytać jak Traefik obsługuje kilka aplikacji Docker Compose przed wdrożeniem w nim middleware uwierzytelniającego.

Jak trudna jest ścieżka aktualizacji?

Na dzień 25 października 2026 r. aktualne wydania to Keycloak 26.8.1, authentik 2026.8.5 oraz Zitadel v4.20.0. Wszystkie trzy narzędzia wykonują migracje schematu w PostgreSQL, co oznacza, że każda aktualizacja wiąże się ze zmianą bazy danych. Zawsze należy najpierw wykonać kopię zapasową bazy danych. Ten jeden nawyk jest cenniejszy niż jakakolwiek funkcja opisana w tym porównaniu.

authentik posiada najbardziej rygorystyczne zasady i określa je jasno: „Aktualizacje muszą odbywać się zgodnie z kolejnością wydań głównych; nie należy przechodzić bezpośrednio ze starszej wersji głównej do najnowszej”. Należy przejść do najnowszej poprawki w ramach każdej wersji przed przejściem do kolejnej, a „authentik nie wspiera procedury przywracania starszej wersji”. Pozostanie w tyle o rok w projekcie z wersjonowaniem kalendarzowym zamienia jedną aktualizację w łańcuch operacji, z których każda wymaga własnej migracji bazy danych.

Przewodnik aktualizacji Keycloak wskazuje wymaganą kolejność: należy przejrzeć zmiany migracyjne z poprzedniej wersji, zaktualizować serwer, a następnie zaktualizować adaptery. Migracja bazy danych uruchamia się automatycznie lub można ją wyeksportować i zastosować ręcznie, co jest przydatne, gdy chce się zapoznać ze zmianami przed ich wprowadzeniem. Kosztem w przypadku Keycloak jest właśnie ta lektura. Informacje o wydaniu zawierają ostrzeżenia o wycofaniu funkcji oraz zmiany w działaniu, które łatwo pominąć, a których zignorowanie może być kosztowne.

Zitadel oddziela fazy inicjalizacji i konfiguracji od działającego serwera, a wytyczne produkcyjne zalecają utrzymywanie ich w rozdzieleniu, aby skalowanie nie powtarzało pracy konfiguracyjnej. Na pojedynczym serwerze VPS oznacza to głównie, że krok konfiguracji musi zakończyć się przed zgłoszeniem przez API stanu gotowości, dlatego plik compose zawiera testy kondycji (health checks), a polecenie startowe wykorzystuje --wait.

Dla kogo przeznaczony jest każdy projekt i gdzie traci swoje atuty

Keycloak to serwer tożsamości firmy Red Hat, stworzony z myślą o organizacjach korzystających z realmów, grup, mapowania ról oraz istniejących katalogów korporacyjnych. Jest to najbardziej kompletna implementacja standardów spośród całej trójki. Traci swoje atuty na VPS o pamięci 2 GB, obsługującym cztery samodzielnie hostowane aplikacje, z których połowa nie wspiera OIDC. Zużycie 1250 MB pamięci RAM przez sam serwer Keycloak (przed doliczeniem bazy danych), konieczność nauki modelu realmów zaprojektowanego dla korporacji oraz wymóg instalacji oauth2-proxy dla aplikacji, na których faktycznie nam zależy, czynią go nieefektywnym w tym scenariuszu.

authentik został stworzony dla użytkowników samodzielnie hostujących usługi, co widać po liście jego funkcji. Oferuje forward auth, dostawcę LDAP oraz wizualny edytor przepływów logowania. Traci swoje atuty, gdy wymagane jest wsparcie producenta bez budżetu klasy enterprise lub gdy cykl wydawniczy nie powinien zmieniać się co kilka tygodni. Wsparcie techniczne dostępne jest wyłącznie w ramach płatnej subskrypcji: wsparcie przez system zgłoszeń w subskrypcjach Enterprise powyżej 1000 USD oraz dedykowane wsparcie z SLA w wersji Enterprise Plus, której ceny zaczynają się od 20 000 USD rocznie. Wersjonowanie oparte na dacie, brak ścieżki powrotu do starszej wersji oraz brak możliwości pomijania wersji generują realne obciążenie operacyjne, a edytor przepływów stanowi cały model do opanowania, podczas gdy rzeczywistym problemem jest często tylko jeden klient OIDC.

Zitadel został stworzony dla programistów wdrażających uwierzytelnianie wewnątrz tworzonego produktu, oferując rozbudowane API oraz wielodostępność (multi-tenancy) jako funkcje priorytetowe. Traci swoje atuty w dokładnie tym przypadku. Cztery kontenery, brak forward auth oraz baza danych wymagająca 4 GB na rdzeń to niewłaściwa konfiguracja dla pojedynczego serwera VPS, na którym uruchomiono menedżer haseł i wiki.

Co i jak uruchomić na jednym VPS

W przypadku jednego serwera VPS z trzema lub czterema własnymi aplikacjami, należy uruchomić authentik. Wszystkie trzy rozwiązania zapewniają ekran logowania. Czynnikiem decydującym jest fakt, że niektóre aplikacje nie obsługują protokołu OIDC, a authentik rozwiązuje ten problem za pomocą wbudowanego mechanizmu forward auth, zamiast wymagać dodatkowego komponentu.

Należy przydzielić 4 GB pamięci RAM, jeśli to możliwe, a 2 GB tylko wtedy, gdy towarzyszące aplikacje są niewielkie. Port 9000 musi pozostać niedostępny z publicznego Internetu, a terminację TLS należy przeprowadzić na reverse proxy znajdującym się przed aplikacją. Należy wykonywać nocne zrzuty bazy PostgreSQL i przechowywać je poza serwerem, ponieważ dostawca tożsamości bez kopii zapasowej stanowi pojedynczy punkt awarii dla każdej aplikacji, którą zabezpiecza. Cały stos należy uruchomić na dedykowanym koncie z ograniczonymi uprawnieniami, zamiast jako root: konfiguracja użytkowników z minimalnymi uprawnieniami na VPS opisuje wymagania dotyczące konta i własności plików.

Należy wybrać Keycloak, gdy każda zabezpieczana aplikacja obsługuje już OIDC lub SAML, albo gdy wymagany jest szczegółowy model ról oferowany przez realm w Keycloak. Należy wybrać Zitadel w przypadku tworzenia aplikacji, do której rejestrują się inni użytkownicy, oraz gdy wymagane jest użycie API i modelu tenantów. Żaden z tych przypadków nie dotyczy scenariusza trzech aplikacji na jednym serwerze, który jest tematem tego wpisu.

Najczęstsze tryby awarii

Keycloak nie posiada danych po restarcie. Uruchomiono go za pomocą start-dev, co wykorzystuje lokalną bazę danych typu development. W kontenerze bez podpiętego wolumenu usunięcie kontenera powoduje utratę realm. Należy przejść na start z parametrem KC_DB=postgres wskazującym na właściwą bazę danych.

Kontener worker aplikacji authentik znika na małym serwerze. Kontener worker oraz server korzystają z tego samego obrazu i oba uruchamiają procesy Python, podczas gdy PostgreSQL wymaga zasobów na hoście z 2 GB pamięci RAM. Należy wykonać docker compose ps, aby potwierdzić, która usługa została zatrzymana, a następnie sprawdzić dmesg pod kątem zdarzeń out-of-memory kill, zanim rozpocznie się poszukiwanie błędów w samej aplikacji.

Konsola Zitadel nie działa za proxy. API Zitadel wykorzystuje gRPC, co wymaga obsługi HTTP/2 aż do backendu. Dokumentacja wymaga użycia reverse proxy wspierającego połączenia HTTP/2 upstream i wymienia przetestowane wersje: Traefik v3.x, NGINX v1.x, Caddy v2.x oraz Apache httpd 2.4.x. Proxy, które obniża wersję połączenia do HTTP/1.1, powoduje, że strona logowania ładuje się poprawnie, ale Konsola przestaje działać.

Każda aplikacja przekierowuje z powrotem do ekranu logowania. Publiczny adres URL serwera SSO oraz adres skonfigurowany w aplikacji muszą być identyczne, wliczając w to schemat oraz port. Keycloak określa to jako ustawienie hostname, a Zitadel jako external domain. W przypadku rozbieżności aplikacja przekierowuje do logowania, którego serwer nie rozpoznaje jako własnego, co powoduje zapętlenie przeglądarki między tymi dwoma adresami.

FAQ

Które z tych trzech rozwiązań pasuje na VPS z 2 GB RAM?

authentik oraz Keycloak. Wymagania systemowe dla authentik określają minimum 2 rdzenie CPU oraz 2 GB pamięci RAM, natomiast przewodnik dotyczący rozmiaru instancji Keycloak wskazuje bazowe zapotrzebowanie na poziomie 1250 MB dla samego serwera, bez uwzględnienia bazy danych. W obu przypadkach 2 GB pamięci RAM to wartość graniczna po dodaniu chronionych aplikacji, dlatego 4 GB należy traktować jako komfortowe minimum. Przewodnik dla Zitadel również wymienia 2 GB RAM dla konfiguracji typu homelab lub półprodukcyjnej, jednak wytyczne dla środowisk produkcyjnych zalecają 4 rdzenie CPU dla operacji haszowania haseł oraz 4 GB RAM na rdzeń bazy danych. Należy zatem oczekiwać, że przy rzeczywistym ruchu logowania 2 GB pamięci okaże się niewystarczające.

Czy Keycloak lub Zitadel mogą chronić aplikację, która nie posiada własnego systemu logowania?

Nie samodzielnie. Żadne z tych rozwiązań nie posiada wbudowanego komponentu forward auth. Stary komponent towarzyszący dla Keycloak, czyli Louketo Proxy, osiągnął status end of life w listopadzie 2020 roku, a jego repozytorium w serwisie GitHub zostało zarchiwizowane w grudniu 2020 roku, więc nie należy opierać na nim żadnych wdrożeń. W takim przypadku należy umieścić oauth2-proxy lub podobny komponent pomiędzy reverse proxy a aplikacją i wskazać go jako klienta OIDC na serwerze SSO. authentik realizuje to natywnie za pomocą dostawcy proxy w trybie "Forward auth (single application)" lub "Forward auth (domain level)".

Które z nich może pełnić rolę serwera LDAP dla aplikacji obsługującej wyłącznie protokół LDAP?

authentik. Jego dostawca LDAP działa w ramach outpost i umożliwia przeszukiwanie użytkowników oraz grup z poziomu authentik za pomocą protokołu LDAP, z obsługą LDAPS dostępną na porcie 636. Dokumentacja obejmuje wyłącznie operacje bind oraz search, dlatego należy traktować to rozwiązanie jako działające w trybie tylko do odczytu. Keycloak oraz Zitadel działają w odwrotnym kierunku: oba rozwiązania odczytują dane z istniejącego katalogu LDAP jako źródło użytkowników i żadne z nich nie odpowiada na zapytania LDAP bind pochodzące z aplikacji.

Czy podczas aktualizacji authentik można pomijać wersje?

Nie. Dokumentacja wskazuje, że aktualizacje muszą odbywać się zgodnie z kolejnością wydań głównych i nie należy przechodzić ze starszej wersji głównej bezpośrednio do najnowszej. Należy najpierw zaktualizować system do najnowszego wydania poprawkowego w ramach bieżącej wersji, a następnie przechodzić o jedną wersję w górę. Przed każdym krokiem należy wykonać kopię zapasową PostgreSQL, ponieważ authentik nie wspiera procedury downgrade, a migracje bazy danych są przeprowadzane wyłącznie w jednym kierunku.

Czy ten artykuł był przydatny?