Instalowanie i budowanie Condui Community

Instalacja lokalna poprzez Docker, Podman lub kod źródłowy.

Condui Community to hostowana lokalnie edycja Condui. Pracuje bez konta, bazy danych i zarządzanej usługi Condui. Możesz samodzielnie zbudować kod źródłowy i uruchomić aplikację na własnym komputerze lub serwerze.

Wersja Community zapisuje projekty w przeglądarce urządzenia, na którym pracujesz. Pobrane archiwa projektów Condui są kompatybilne z hostowaną wersją w obu kierunkach.

Wyświetl kod źródłowy społeczności Condui na GitHub.

Którą metodę instalacji wybrać?

Dołączony Dockerfile buduje standardowy obraz kontenera OCI. Obraz mogą zbudować także inne narzędzia zgodne ze standardem OCI, ale przetestowane ścieżki instalacji obejmują Docker i Podman.

Wymagania

Do Docker Compose lub Podman potrzebujesz:

• Git lub pobrana kopia repozytorium;
• Docker z wtyczką Compose lub najnowszą instalacją Podmana;
• wolny port lokalny, domyślny 8080; i
• nowoczesna przeglądarka.

Do bezpośredniej kompilacji źródłowej będziesz potrzebować Node.js 24 i npm. Nie jest wymagany projekt Supabase, konto w chmurze ani osobna baza danych.

Zainstaluj za pomocą Docker Compose

1. Pobierz repozytorium i otwórz folder projektu:

git clone https://github.com/Xoliul/condui-community.git
cd condui-community

1. Zbuduj i uruchom kontener:

docker compose up --build -d

1. Otwórz http://localhost:8080. Po uruchomieniu kontenera pojawi się strona główna Condui Community.

1. Sprawdź status lub logi, jeśli to konieczne:

docker compose ps
docker compose logs -f

Zatrzymaj aplikację za pomocą:

docker compose down

Zainstaluj za pomocą Podmana

Najpierw zbuduj obraz OCI:

podman build -t condui-community:local .

Następnie uruchom kontener:

podman run --name condui-community --rm -p 8080:8080 condui-community:local

Otwórz http://localhost:8080. Naciśnij Ctrl+C, aby zatrzymać kontener. W Podman Compose możesz również użyć dołączonego pliku compose.yaml.

Kompiluj i uruchamiaj z kodu źródłowego

Najpierw sprawdź, czy Node.js 24 działa:

node --version

Zainstaluj zależności zapisane w repozytorium, zbuduj wersję produkcyjną i uruchom serwer lokalny:

npm ci --ignore-scripts
npm run build
npm start

Następnie otwórz http://localhost:8080. Serwer lokalny udostępnia aplikację internetową oraz lokalne punkty końcowe konwersji obsługiwanych plików planów.

Aby zaktualizować

Pobierz najnowszą wersję repozytorium Community i ponownie zbuduj kontener:

git pull
docker compose up --build -d

Utwórz archiwum ważnych projektów przed aktualizacją. Obsługiwane archiwa są migrowane po otwarciu, ale prywatna kopia zapasowa pozostaje najbezpieczniejszą opcją odzyskiwania.

Przechowywanie projektów i kopie zapasowe

Projekty znajdują się w pamięci przeglądarki, a nie w kontenerze. Zastąpienie lub przebudowa kontenera zwykle nie powoduje wymazania pamięci przeglądarki. Przeglądarka traktuje każdą kombinację protokołu, nazwy hosta i portu jako osobne źródło. Dlatego przełączenie z localhost:8080 na inną nazwę hosta lub port może spowodować wyświetlenie pustej listy projektów.

Regularnie pobieraj ważne projekty w postaci archiwum projektu Condui i przechowuj je w kopii zapasowej. PDF jest dokumentem ostatecznym i nie zawiera osadzonego, edytowalnego projektu w Edycji społecznościowej.

Brak zarządzanej kopii zapasowej i wsparcia

Instalacja społecznościowa nie obejmuje zarządzanej pamięci masowej w chmurze, usługi odzyskiwania ani oficjalnej gwarancji wsparcia. Osoba zarządzająca instalacją jest odpowiedzialna za aktualizacje, dostępność i kopie zapasowe.

Typowe problemy

• Port 8080 jest już w użyciu: w compose.yaml na przykład zmień 8080:8080 na 8081:8080, a następnie otwórz http://localhost:8081.
• Kompilacja kodu źródłowego nie uruchamia się: sprawdź, czy node --version pokazuje wersję 24.
• Lista projektów wydaje się pusta: otwórz aplikację ponownie, używając dokładnie tej samej nazwy hosta i portu, albo zaimportuj wcześniej pobrane archiwum projektu.
• Kontener zatrzymuje się podczas budowania: wyświetl docker compose logs i sprawdź, czy Docker ma wystarczającą ilość pamięci i wolnego miejsca na dysku.
• Przeglądarka wyświetla pustą stronę: otwórz jej konsolę programisty. Aplikacja Community działa w przeglądarce; dzienniki Dockera pokazują tylko, czy lokalny serwer WWW został uruchomiony.