Samodzielny hosting Planka z Docker Compose
Wdrożenie Planka na VPS z Docker Compose obejmuje Postgresa, Traefika i zmienne startowe administratora. Sprawdź też, dlaczego błędny BASE_URL blokuje logowanie.
Co zyskuje się dzięki samodzielnemu utrzymywaniu Planka
Samodzielne utrzymywanie Planka zapewnia zespołowi tablicę Kanban z modelem kart, list i etykiet znanym już z Trello, działającą na kontrolowanym VPS. Nie ma limitu użytkowników ani rozliczeń za użytkownika, ponieważ jedynym kosztem jest serwer. W tym poradniku aplikacja jest wdrażana za pomocą Docker Compose za Traefikiem, z użyciem Postgresa do przechowywania danych oraz nazwanego wolumenu dla każdego przesyłanego pliku.
Planka 2 jest wydawany na podstawie własnej Fair Use License projektu, którą projekt określa jako source-available, a nie open source. Używanie go do wewnętrznych projektów własnej organizacji jest dozwolone. Oferowanie go podmiotom trzecim jako komercyjnej usługi hostowanej wymaga licencji Pro lub Enterprise.
Poradnik jest przeznaczony dla zespołu liczącego od dwóch do pięciu osób, który rezygnuje z bezpłatnego planu Trello. Jeśli wybór tablicy nie został jeszcze dokonany, najpierw należy przeczytać porównanie samodzielnie utrzymywanych alternatyw dla Trello. W tym poradniku przyjęto, że wybór został już dokonany, i opisano wyłącznie wdrożenie.
Potrzebny jest VPS z uruchomionym Docker Engine i wtyczką Compose oraz rekordem DNS A wskazującym na ten serwer. Potrzebna jest również instancja Traefik, która już kończy połączenia TLS (transport layer security) na tym serwerze. Jeśli Traefik nie został jeszcze skonfigurowany, należy najpierw skonfigurować reverse proxy Traefik przed kilkoma aplikacjami Compose, a jeśli poniższy plik jest nieznany, przeczytać podstawy Docker Compose na VPS.
Ile zasobów VPS potrzebuje Planka?
Techniczne FAQ projektu zaleca co najmniej 2 GB RAM i 10 GB przestrzeni dyskowej dla małych zespołów. Należy traktować te wartości jako punkt wyjścia, a nie jako wynik pomiaru.
W praktyce uruchamiane komponenty są niewielkie: jeden proces Node.js obsługuje API i zbudowany frontend, a serwer Postgres przechowuje dane. Postgres uruchamia proces nadzorujący oraz po jednym procesie backendu dla każdego otwartego połączenia. W kontenerze Planka działa również mały proces proxy, który filtruje żądania wychodzące. Plan z 2 GB odpowiada zaleceniom projektu dotyczącym pamięci RAM dla małych zespołów. Tablica nie obciąża znacząco serwera, więc jeśli ten sam VPS ma również przechowywać dokumenty zespołu, należy najpierw dobrać zasoby do tej aplikacji: uruchomienie AFFiNE jako obszaru roboczego w stylu Notion wymaga około dwóch gigabajtów na własne potrzeby, zanim Planka zacznie potrzebować dodatkowych zasobów.
Najpierw dobierz rozmiar dysku, a dopiero potem pamięci, ponieważ załączniki zajmują coraz więcej miejsca. Zamiast polegać na informacjach z tego akapitu, zmierz własną instancję:
docker stats --no-stream
docker system df -vPierwsze polecenie wyświetla bieżące zużycie pamięci i procesora przez każdy kontener. Drugie pokazuje ilość miejsca zajmowaną przez każdy wolumen. Wykonaj oba pomiary po normalnym tygodniu pracy, a nie w dniu instalacji, ponieważ bezczynna tablica nie odzwierciedla potrzeb zespołu.
Napisz plik Compose
Utwórz katalog i zmień jego właściciela, aby nie trzeba było edytować tych plików przez sudo.
sudo mkdir -p /opt/planka
sudo chown "$USER":"$USER" /opt/planka
cd /opt/plankaWygeneruj sekrety do pliku .env obok pliku Compose. Compose odczyta ten plik automatycznie i wstawi wartości w odpowiednie miejsca.
umask 077
{
printf 'SECRET_KEY=%s\n' "$(openssl rand -hex 64)"
printf 'POSTGRES_PASSWORD=%s\n' "$(openssl rand -hex 24)"
printf 'ADMIN_PASSWORD=%s\n' "$(openssl rand -hex 12)"
} > .env
chmod 600 .envopenssl rand -hex jest użyte celowo. Ciąg szesnastkowy zawiera wyłącznie cyfry oraz litery od a do f, więc nie może uszkodzić ciągu połączenia DATABASE_URL, do którego zostanie wstawiony. Standardowe Base64 może zawierać ukośnik, znak plus i znak równości używany do dopełnienia, ale nigdy znak małpy; znaki o specjalnym znaczeniu w adresie URL połączenia wymagają kodowania procentowego. Szersze omówienie znajduje się w przechowywaniu sekretów poza plikiem Compose.
Teraz docker-compose.yml. Zastąp kanban.example.com własną nazwą hosta w obu miejscach, w których występuje.
services:
planka:
image: ghcr.io/plankanban/planka:2.2.1
restart: unless-stopped
volumes:
- planka-data:/app/data
environment:
- BASE_URL=https://kanban.example.com
- DATABASE_URL=postgresql://planka:${POSTGRES_PASSWORD}@postgres/planka
- SECRET_KEY=${SECRET_KEY}
- TRUST_PROXY=true
- DEFAULT_ADMIN_EMAIL=you@example.com
- DEFAULT_ADMIN_PASSWORD=${ADMIN_PASSWORD}
- DEFAULT_ADMIN_NAME=Your Name
- DEFAULT_ADMIN_USERNAME=admin
networks:
- proxy
- internal
labels:
- "traefik.enable=true"
- "traefik.docker.network=proxy"
- "traefik.http.routers.planka.rule=Host(`kanban.example.com`)"
- "traefik.http.routers.planka.entrypoints=websecure"
- "traefik.http.routers.planka.tls.certresolver=default"
- "traefik.http.services.planka.loadbalancer.server.port=1337"
depends_on:
postgres:
condition: service_healthy
postgres:
image: postgres:16-alpine
restart: unless-stopped
volumes:
- db-data:/var/lib/postgresql/data
environment:
- POSTGRES_DB=planka
- POSTGRES_USER=planka
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
networks:
- internal
healthcheck:
test: ["CMD-SHELL", "pg_isready -U planka -d planka"]
interval: 10s
timeout: 5s
retries: 5
volumes:
planka-data:
db-data:
networks:
proxy:
external: true
internal:Warto wyjaśnić cztery decyzje w tym pliku, ponieważ to właśnie te elementy są często zmieniane, a później powodują problemy.
- Usługa Planka nie zawiera bloku
ports:. Traefik łączy się z kontenerem przez siećproxy, więc port 1337 nie jest publikowany na hoście. Jego publikacja umożliwiłaby ominięcie proxy i certyfikatu. loadbalancer.server.port=1337określa port wewnątrz kontenera. Planka nasłuchuje na porcie 1337, a przykład nadrzędny uzyskuje do niego dostęp przez port 3000 tylko dlatego, że mapuje ten port na hoście. Tutaj nie ma mapowania hosta, więc Traefik musi otrzymać informację o porcie kontenera.condition: service_healthywspółdziała z testem stanu Postgres. Bez tego ustawienia Planka uruchamia się, zanim baza danych zacznie akceptować połączenia, wykonuje pierwsze zapytanie, które kończy się niepowodzeniem, i zamyka proces. Wygląda to jak pętla awarii i restartów. Mechanizm opisano w testach stanu Compose i kolejności uruchamiania.- Usługa bazy danych celowo nosi nazwę
postgres. Planka 2 kieruje własne żądania wychodzące przez wewnętrzny filtr, którego domyślna lista blokad tolocalhost,postgres. Zmiana nazwy usługi powoduje ciche usunięcie bazy danych z tej listy.
Sprawdź, czy Compose widzi sekrety, zanim uruchomisz jakiekolwiek usługi:
docker compose config | grep -E 'image:|BASE_URL|POSTGRES_USER'Polecenie wyświetla plik z wartościami .env już podstawionymi. Pusta wartość oznacza, że Compose nie odczytuje pliku .env. Zwykle przyczyną jest uruchomienie polecenia z innego katalogu.
Co faktycznie robią zmienne inicjalizacji konta administratora
Od wersji Planka 1.13 konto administratora nie jest tworzone automatycznie, więc świeża baza danych nie zawiera użytkownika, który może się zalogować. Grupa DEFAULT_ADMIN_* jest jednym z dwóch sposobów rozwiązania tego problemu.
Podczas uruchamiania Planka wyszukuje użytkownika odpowiadającego wartości DEFAULT_ADMIN_EMAIL. Jeśli go nie znajdzie, tworzy konto przy użyciu hasła, nazwy wyświetlanej i nazwy użytkownika ustawionych obok tej zmiennej. Przy kolejnych uruchomieniach aktualizuje również pasujące konto na podstawie tych zmiennych, w tym resetuje jego hasło, jeśli DEFAULT_ADMIN_PASSWORD nadal jest ustawione.
DEFAULT_ADMIN_EMAIL pełni drugą funkcję, która często powoduje problemy. Dopóki ta zmienna jest ustawiona, za pośrednictwem interfejsu nie można zmienić nazwy, roli ani adresu e-mail wskazanego przez nią konta. Nie można też usunąć tego konta. Jest to zabezpieczenie przed utratą dostępu. Z tego powodu tej nazwy konta ani jego adresu e-mail nie można zmienić w interfejsie. Usuń zmienną i uruchom ponownie usługę. Konto stanie się zwykłym kontem administratora, które można edytować tak jak każde inne.
Szczególnej uwagi wymaga wiersz z hasłem. Wszystko w environment: może odczytać każdy, kto może uruchomić docker inspect w kontenerze, dlatego DEFAULT_ADMIN_PASSWORD nie powinno pozostać tam na stałe. Zaloguj się, usuń ten wiersz, uruchom ponownie docker compose up -d, a następnie zmień hasło w interfejsie.
Czystsze rozwiązanie całkowicie pomija te zmienne. Zakomentuj całą grupę DEFAULT_ADMIN_*, a następnie utwórz konto interaktywnie:
docker compose run --rm planka npm run db:create-admin-userPolecenie poprosi o adres e-mail, hasło, nazwę wyświetlaną i opcjonalną nazwę użytkownika, po czym zapisze użytkownika bezpośrednio w bazie danych. Hasło nie trafia ani do pliku Compose, ani do skonfigurowanego środowiska kontenera. Tej metody należy użyć, jeśli więcej niż jedna osoba ma dostęp powłoki do VPS. Polecenie najpierw uruchamia Postgres z powodu depends_on, więc działa również na stosie, który nigdy wcześniej nie został uruchomiony.
W obu przypadkach hasła Planka trzeba później zarządzać ręcznie. Do wersji 2.1.1 edycja Community mogła przekazywać logowanie do dostawcy OIDC, takiego jak Authentik działający jako własny serwer jednokrotnego logowania, ale w wersji 2.2.0, wydanej w sierpniu 2026, obsługa OIDC i SSO została przeniesiona do PLANKA Pro. W tej samej wersji edycja Community zyskała uwierzytelnianie dwuskładnikowe (TOTP) dla kont lokalnych, dlatego należy je włączyć przynajmniej dla konta administratora.
Dlaczego BASE_URL powoduje problemy z logowaniem, gdy nie odpowiada nazwie hosta
BASE_URL to dokładny adres wpisywany przez użytkowników w przeglądarce, ze schematem i bez końcowego ukośnika. W tym stosie jest to https://kanban.example.com. Planka tworzy na podstawie tej wartości własne odnośniki oraz listę dozwolonych źródeł WebSocket. Oznacza to, że nieprawidłowa wartość BASE_URL nie powoduje jednoznacznego błędu. Strona wczytuje się, ale proces wczytywania nigdy się nie kończy.
Typowy przypadek wygląda następująco: kopiowany jest przykład z dokumentacji upstream, pozostawiana jest wartość BASE_URL=http://localhost:3000, a witryna jest otwierana przez HTTPS pod właściwą domeną. Formularz logowania jest wysyłany, a dane uwierzytelniające zostają zaakceptowane. Tablica się jednak nie pojawia. W konsoli deweloperskiej przeglądarki widoczne są nieudane żądania do /socket.io/, ponieważ gniazdo łączy się ze źródłem strony w przeglądarce, natomiast ograniczenie źródeł po stronie serwera zezwala na źródło wynikające z BASE_URL.
TRUST_PROXY=true to druga część tego samego problemu. Planka działa za Traefik, dlatego każde żądanie dociera do niej z adresu proxy przez zwykły HTTP w sieci Docker. Bez TRUST_PROXY aplikacja ignoruje nagłówki X-Forwarded-Proto i X-Forwarded-For ustawiane przez Traefik. W efekcie uznaje połączenie za niezabezpieczone i traktuje wszystkich klientów jako jeden wspólny adres IP. Po ustawieniu tej wartości aplikacja odczytuje te nagłówki i uzgadnia schemat z przeglądarką.
Traefik obsługuje proxy dla WebSocket bez dodatkowej konfiguracji, co jest jednym z powodów, aby preferować go w tym przypadku. W nginx proxy musi przekazywać nagłówki aktualizacji połączenia, proxy_set_header Upgrade $http_upgrade i proxy_set_header Connection "upgrade". W przeciwnym razie pojawi się ten sam zablokowany wskaźnik ładowania, ale z innej przyczyny. Mogą one znajdować się w ogólnym bloku location /. Oddzielny blok dla /socket.io również działa, ale nie jest wymagany.
Późniejsze przeniesienie tablicy pod nową nazwę hosta wymaga jednoczesnej zmiany dwóch elementów: wartości BASE_URL oraz reguły Host() w Traefik. Po zmianie tylko jednego z nich ponownie pojawi się zablokowany wskaźnik ładowania. Udostępnianie Planka w podścieżce, takiej jak https://example.com/planka, działa od wersji 2.1.0, wydanej w marcu 2026. W starszych tagach należy użyć osobnej subdomeny.
Miejsce przechowywania załączników i awatarów przez Planka
Planka 2 przechowuje wszystkie pliki przesyłane przez użytkowników w jednej ścieżce wewnątrz kontenera: /app/data. Znajdują się tam załączniki, awatary użytkowników oraz obrazy tła tablic. W wersji 1 używano trzech osobnych katalogów, dlatego plik Compose skopiowany ze starszego opracowania montuje ścieżki, które już nie istnieją, a właściwe montowanie danych nie jest skonfigurowane.
To pojedyncze montowanie decyduje o tym, czy tablica przetrwa aktualizację, czy też aktualizacja spowoduje problemy. Obraz Docker deklaruje /app/data jako volume, więc pominięcie montowania w Compose zapisuje przesyłane pliki w anonimowym volume. Compose zachowuje go podczas zwykłego odtworzenia up, ale późniejsze wykonanie down, a następnie up, nie podłącza go automatycznie ponownie. Tablica uruchamia się poprawnie, wszystkie karty nadal istnieją, ale każdy odnośnik do załącznika jest nieaktywny, ponieważ rekordy w bazie danych nadal wskazują pliki znajdujące się w starym volume.
Nazwany volume z powyższego pliku Compose zapobiega temu problemowi. Bind mount również działa i ułatwia tworzenie kopii zapasowych plików za pomocą standardowych narzędzi, ale wymaga dodatkowego kroku. Proces Node w kontenerze działa z UID 1000, dlatego katalog na hoście należący do root powoduje błąd uprawnień przy pierwszym przesyłaniu pliku:
sudo chown -R 1000:1000 /opt/planka/dataRóżnice między tymi rozwiązaniami omówiono w bind mountach i nazwanych volume.
Jeśli załączniki przekroczą pojemność dysku dostępnego w wybranym planie, Planka może zamiast tego zapisywać je w magazynie zgodnym z S3 za pośrednictwem S3_ENDPOINT, S3_BUCKET oraz odpowiadających im zmiennych kluczy. Można w ten sposób wskazać zarządzany bucket albo samodzielnie hostowany magazyn obiektowy MinIO na innym serwerze. Należy zdecydować o tym przed zapełnieniem tablicy przez zespół, ponieważ włączenie S3 przełącza odczyt i zapis plików na ten backend bez migracji istniejących plików.
Uruchomienie stosu i weryfikacja działania
docker compose pull
docker compose up -d
docker compose psdocker compose ps powinno wykazać postgres jako healthy oraz planka jako running. Jeśli Planka restartuje się w pętli, w pierwszej kolejności należy sprawdzić połączenie z bazą danych, a nie samą aplikację.
docker compose logs -f plankaPoprawny pierwszy rozruch uruchamia migracje bazy danych, jednak konfiguracja produkcyjna ustawia noShip: true i pomija komunikat startowy informujący o porcie 1337. Należy potwierdzić, że schemat został poprawnie wgrany, odpytując bezpośrednio Postgres, zamiast polegać na logach:
docker compose exec postgres psql -U planka -d planka -c '\dt'Lista tabel zawierająca board oraz card oznacza, że migracje zostały wykonane. Komunikat "Did not find any relations" oznacza, że Planka nie nawiązała połączenia, więc należy porównać DATABASE_URL z wartościami POSTGRES_USER oraz POSTGRES_PASSWORD w pliku .env.
Następnie należy sprawdzić trasę z własnej maszyny, a nie z poziomu VPS:
curl -I https://kanban.example.comHTTP/2 200 oznacza, że Traefik posiada certyfikat i łączy się z kontenerem. Błąd 404 serwowany przez Traefik oznacza, że żaden router nie dopasował żądania: reguła Host() nie pasuje do żądanej nazwy hosta lub Traefik nie odczytał etykiet. Błąd 502 oznacza, że router dopasował żądanie, ale Traefik nie mógł połączyć się z kontenerem, na przykład z powodu braku podpięcia do sieci proxy. Teraz otwórz stronę i zaloguj się na konto administratora.
Wykonaj pg_dump przed każdą zmianą wersji
Dwa oddzielne magazyny przechowują dane tablicy, dlatego kopia zapasowa musi obejmować oba: bazę danych Postgres oraz wolumen planka-data. Zrzut bazy danych wykonaj podczas działania stosu.
docker compose exec -T postgres pg_dump -U planka -d planka > "planka-db-$(date +%F).sql"Opcja -T wyłącza domyślną alokację pseudo-terminala przez Compose, dzięki czemu zrzut pozostaje zwykłym strumieniem wyjściowym.
Następnie wykonaj kopię plików przesyłanych do aplikacji. Najpierw ustal rzeczywistą nazwę wolumenu, ponieważ Compose dodaje do niej prefiks zawierający nazwę katalogu projektu.
docker volume ls | grep planka
docker run --rm -v planka_planka-data:/data -v "$PWD":/backup alpine \
tar czf /backup/planka-files-$(date +%F).tgz -C /data .W repozytorium projektu znajdują się również docker-backup.sh i docker-restore.sh, a oficjalna dokumentacja zaleca uruchamianie ich w ramach nocnego zadania cron. Oba podejścia są prawidłowe. Niedopuszczalna jest natomiast kopia zapasowa, której nigdy nie odtworzono. Dlatego raz odtwórz ją na tymczasowym VPS i potwierdź, że można się zalogować oraz otworzyć załącznik. Ta sama para magazynów występuje w każdej aplikacji Compose, która przyjmuje pliki przesyłane przez użytkowników. Jeśli później uruchomisz Chatwoot na tym samym serwerze co system obsługi zgłoszeń, przygotowana procedura będzie wymagała jedynie niewielkich zmian nazw wolumenów.
Wykonaj zrzut bezpośrednio przed każdą zmianą wersji. Kopia z ubiegłej nocy nie jest tym samym co kopia wykonana przed migracją, którą zamierzasz uruchomić.
Przypinanie tagów i lektura informacji o wydaniu
Oba tagi obrazów w tym pliku są celowo przypięte.
ghcr.io/plankanban/planka:2.2.1 to konkretne wydanie, aktualne na październik 2026. Wersja Community 2.3.0 została wydana 4 listopada 2026 roku, zawiera poprawki bezpieczeństwa i producent zaleca aktualizację. Wersja Community 2.3.1 pojawiła się 5 listopada 2026 roku, naprawiając błąd powodujący awarię podczas edycji opisów kart na tablicach z członkiem nieposiadającym nazwy użytkownika. latest zmienia się za każdym razem, gdy producent publikuje nową wersję, więc rutynowe docker compose pull może wprowadzić migrację schematu w nieoczekiwanym momencie. Przed zmianą tego numeru należy przeczytać informacje o wydaniu, ponieważ to tam opisane są zmiany powodujące niekompatybilność oraz poprawki bezpieczeństwa. Wersja 2.0.3 została opublikowana jako wydanie bezpieczeństwa; jest to dokładnie ten rodzaj informacji, który należy przeczytać, zamiast przyjmować go przypadkiem. Podobnie było z wersją 2.2.1, wydaną w sierpniu 2026 roku: naprawia ona lukę path traversal, która pozwalała zalogowanemu użytkownikowi na odczyt dowolnych plików w instancjach korzystających z lokalnego przechowywania plików, co jest konfiguracją opisaną w tym przewodniku, a biuletyn wskazuje wersje 2.1.1 i wcześniejsze jako podatne. Jeśli przechodzisz z wersji 2.1.x, najpierw przeczytaj notatki do 2.2.0, ponieważ to wydanie dezaktywuje użytkowników, którzy logowali się wyłącznie przez SSO, dopóki administrator nie nada im hasła i nie aktywuje ich ponownie. Przypinanie jest tutaj łatwe, ponieważ producent publikuje obrazy, a tam, gdzie projekt ich nie dostarcza, należy zachować taką samą dyscyplinę z dodatkowym krokiem, jak w przypadku openGym zbudowanego na maszynie z pobranego tagu git.
postgres:16-alpine jest przypięte do głównej wersji z ważniejszego powodu. Postgres zapisuje swój katalog danych w formacie powiązanym z główną wersją, a serwer odmawia otwarcia katalogu zapisanego przez inną wersję. Wpisz postgres:latest, pozwól tagowi przekroczyć 16, a kontener nie wystartuje. Obraz 17 na przykład zatrzymuje się z komunikatem:
FATAL: database files are incompatible with server
DETAIL: The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17.Nic nie zostaje utracone i nic nie naprawia się przez zwykły restart. Przejście na nową główną wersję Postgres oznacza zrzut danych ze starej wersji i przywrócenie ich do świeżego katalogu danych na nowej, uruchomienie pg_upgrade, które konwertuje dane bez zrzutu, ale wymaga dostępności binariów starego i nowego serwera jednocześnie, lub replikację logiczną do serwera z nową wersją, po której następuje przełączenie. Każda z tych ścieżek to zaplanowana migracja, a nie efekt uboczny pobrania obrazu; replikacja logiczna pozwala staremu serwerowi działać, podczas gdy nowy nadrabia zaległości.
Jeśli przenosisz istniejącą instalację Planka 1.x zamiast zaczynać od zera, ta aktualizacja posiada własną udokumentowaną procedurę w dokumentacji projektu i nie ma możliwości powrotu do wersji 1 bez wcześniejszego wykonania kopii zapasowej.
Tryby awarii i komunikaty wyświetlane w dzienniku
Planka uruchamia się ponownie w pętli, a dziennik wskazuje bazę danych. Dane uwierzytelniające w DATABASE_URL nie są zgodne ze zmiennymi środowiskowymi Postgres. Należy pamiętać, że POSTGRES_PASSWORD jest stosowana tylko podczas pierwszej inicjalizacji katalogu danych. Dlatego poprawienie tej zmiennej po nieudanym pierwszym uruchomieniu niczego nie zmieni. Hasło roli bazy danych należy zmienić za pomocą ALTER ROLE, aby było zgodne ze skonfigurowanym hasłem. Usunięcie wolumenu db-data jest rozwiązaniem wyłącznie dla instalacji tymczasowej, w której nie ma danych do zachowania.
Logowanie kończy się powodzeniem, ale tablica nigdy się nie ładuje. BASE_URL nie jest zgodne z adresem widocznym w pasku przeglądarki, więc serwer odrzuca origin gniazda. Konsola przeglądarki pokazuje nieudane żądania do /socket.io/.
Przesyłanie plików kończy się niepowodzeniem, a pozostałe funkcje działają. Zamontowany katalog należy do root. Należy uruchomić sudo chown -R 1000:1000 dla katalogu na hoście, a następnie ponownie uruchomić kontener.
Załączniki zniknęły po aktualizacji. /app/data nie było podłączone do oryginalnego wolumenu przesyłanych plików. Należy ponownie podłączyć ten wolumen albo przywrócić pliki z kopii zapasowej. Przed kolejną zmianą znacznika obrazu należy użyć nazwanego wolumenu.
Traefik zwraca 404. Żaden router nie dopasował żądania: reguła Host() nie pasuje do rekordu DNS albo etykiety nie dotarły do Traefik. docker compose config pokazuje etykiety po podstawieniu wartości. W tym miejscu widoczne są literówki. Kod 502 oznacza natomiast, że trasa została dopasowana, ale nie można było połączyć się z kontenerem. Należy sprawdzić, czy kontener znajduje się w sieci proxy.
Powiadomienia lub webhooki nigdy nie docierają. Planka 2 wysyła wychodzące żądania HTTP przez wewnętrzny filtr, a domyślna lista blokad obejmuje localhost i postgres. Webhook skierowany do localhost jest blokowany celowo. Po ustawieniu OUTGOING_ALLOWED_HOSTS blokowany jest również każdy host, którego nie ma na tej liście. Należy skierować webhook do nazwy usługi drugiego kontenera i dodać tę nazwę do OUTGOING_ALLOWED_HOSTS, jeśli używana jest lista dozwolonych hostów, zamiast usuwać filtr.
Po uruchomieniu obciążenie operacyjne jest niewielkie. Należy śledzić informacje o wydaniach i wykonywać zrzut bazy danych przed każdą aktualizacją. Po ponownym uruchomieniu systemu stos uruchomi się automatycznie dzięki restart: unless-stopped, o ile sama usługa Docker jest włączona przy starcie systemu. Przypadki, w których tak się nie dzieje, opisano w Stosy Compose uruchamiane ponownie po restarcie systemu.
FAQ
Dlaczego Planka ładuje się bez końca po zalogowaniu?
Dane uwierzytelniające zostały zaakceptowane, ale połączenie na żywo nie zostało ustanowione. Przeglądarka otwiera gniazdo względem originu strony, natomiast Planka wyznacza dozwolone originy gniazd na podstawie BASE_URL. Pozostawienie tej zmiennej z wartością http://localhost:3000 podczas otwierania witryny pod adresem https://kanban.example.com powoduje odrzucenie połączenia przez serwer. Konsola deweloperska pokazuje nieudane żądania do /socket.io/. Ustaw BASE_URL na dokładny publiczny adres bez końcowego ukośnika, dodaj TRUST_PROXY=true, aby aplikacja uwzględniała nagłówek X-Forwarded-Proto z reverse proxy, a następnie uruchom docker compose up -d.
Jak utworzyć pierwszego administratora Planka?
Od wersji 1.13 administrator nie jest tworzony automatycznie. Ustaw DEFAULT_ADMIN_EMAIL wraz z odpowiadającymi mu zmiennymi hasła, nazwy i nazwy użytkownika, a następnie uruchom stack, albo wykonaj docker compose run --rm planka npm run db:create-admin-user i odpowiedz na pytania. Polecenie interaktywne jest bezpieczniejsze na współdzielonym serwerze, ponieważ hasło nie trafia do skonfigurowanego środowiska kontenera, z którego docker inspect może je odczytać. Pozostawienie DEFAULT_ADMIN_EMAIL ustawionej po zakończeniu konfiguracji uniemożliwia zmianę nazwy, roli i adresu e-mail tego konta oraz blokuje jego usunięcie z interfejsu. Po zakończeniu konfiguracji usuń DEFAULT_ADMIN_PASSWORD, ponieważ pozostawienie tej zmiennej powoduje reset hasła odpowiadającego jej konta przy uruchamianiu.
Gdzie Planka przechowuje załączniki i awatary?
Wszystkie przesłane pliki są przechowywane w kontenerze pod /app/data w Planka 2, w tym załączniki, awatary użytkowników i tła tablic. Zamontuj tę ścieżkę jako nazwany wolumen. Bez jawnego montowania obraz Docker używa wolumenu anonimowego, którego kolejne docker compose up nie podłącza automatycznie po docker compose down. Można również użyć bind mount, ale proces Node działa jako UID 1000. Wykonaj sudo chown -R 1000:1000 dla katalogu na hoście, w przeciwnym razie przesyłanie plików zakończy się błędem uprawnień.
Ile pamięci RAM wymaga Planka hostowana samodzielnie?
Techniczne FAQ projektu zaleca co najmniej 2 GB pamięci RAM i 10 GB przestrzeni dyskowej dla małych zespołów. Domyślne wdrożenie Docker uruchamia proces Node, serwer Postgres z procesem backendu dla każdego otwartego połączenia oraz wewnętrzny proxy Squid do filtrowania żądań wychodzących. Wykonaj docker stats --no-stream po normalnym tygodniu pracy i dobierz zasoby na podstawie własnych danych. Monitoruj dysk uważniej niż pamięć, ponieważ to załączniki zwiększają zajętość.
Jak zaktualizować Planka bez utraty danych?
Bezpośrednio przed aktualizacją wykonaj zrzut bazy danych i zarchiwizuj wolumen z przesłanymi plikami. Nie polegaj na harmonogramie z poprzedniej nocy. Użyj docker compose exec -T postgres pg_dump -U planka -d planka > planka-db.sql, zachowując -T, aby wyłączyć alokację pseudoterminala dla przekierowanego wyjścia. Przeczytaj informacje o wydaniu każdej pomijanej wersji, zmień tag obrazu na konkretną wersję zamiast latest, a następnie uruchom docker compose pull i docker compose up -d oraz monitoruj dziennik pod kątem migracji. Pozostaw tag Postgres przypięty do jego głównej wersji, ponieważ serwer odmawia otwarcia katalogu danych zapisanego przez inną główną wersję.