Docker Compose

basedb jest publikowany jako jeden obraz, eodia/basedb, dla amd64 i arm64. Plik docker-compose.yml z repozytorium łączy go z PostgreSQL. Cała konfiguracja odbywa się przez plik .env (zobacz Zmienne środowiskowe).

Obraz

Zawiera trzy procesy basedb i serwuje je na jednym porcie, 3000:

Ścieżka	Proces
/api/*, /auth/*, /healthz	API REST, logowanie, zadania w tle
/mcp	serwer MCP dla agentów
cała reszta – /, /f/…, /v/…	interfejs

Przy starcie API uruchamia się pierwsze: na pustej bazie stosuje katalog i tworzy pierwszego administratora; przy kolejnych startach oba kroki nie mają żadnego efektu. Serwer MCP startuje, gdy tylko API odpowiada. Jeśli jeden z procesów się zatrzyma, zatrzymuje się cały kontener, a polityka ponownego uruchamiania uruchamia go ponownie w całości.

Obraz działa jako użytkownik node, na Node 22, deklaruje sprawdzanie stanu (/healthz) i wolumen /data na pliki z pól Plik i Obraz.

Tag	Zawartość
latest	najnowsza opublikowana wersja
0.7	najnowsza wersja 0.7.x
0.7.1	dokładnie ta wersja

Usługi

Usługa	Obraz	Port (na 127.0.0.1)	Wolumen
db	postgres:16-alpine	5432	db-data
basedb	eodia/basedb	3000	files → /data
proxy (opcjonalnie)	caddy:2-alpine	80, 443	caddy-data, caddy-config

Przydatne polecenia

docker compose up -d                # pobierz obraz i uruchom
docker compose logs -f basedb       # śledź basedb (hasło administratora przy 1. starcie)
docker compose ps                   # stan i kondycja usług
docker compose restart basedb       # uruchom ponownie basedb
docker compose down                 # zatrzymaj (wolumeny zostają)

W sklonowanym repozytorium docker compose up -d --build buduje obraz z kodu, zamiast go pobierać.

Za bramą, pod ścieżką

Gdy basedb jest publikowany pod ścieżką – https://passerelle.example.com/basedb/, a nie w katalogu głównym domeny –, wskaż tę ścieżkę:

BASEDB_PUBLIC_URL=https://passerelle.example.com/basedb
# albo, bez publicznego adresu:
BASEDB_BASE_PATH=/basedb

Wszystko przechodzi wtedy pod /basedb: interfejs, /basedb/api, /basedb/mcp, linki udostępniania i te z e-maili. Brama może zachować ścieżkę, przekazując żądanie dalej, albo ją usunąć: basedb akceptuje obie możliwości. BASEDB_BASE_PATH=/ wymusza katalog główny.

Obraz jest taki sam dla każdego adresu: ścieżka jest zapisywana w interfejsie przy starcie kontenera, a zmiana ścieżki wymaga tylko ponownego uruchomienia.

Zmiana portów

BASEDB_PORT=3100
POSTGRES_PORT=5433

Istniejąca baza PostgreSQL

Ustaw DATABASE_URL: basedb łączy się z nią zamiast z kontenerem db (który i tak się uruchamia, nieużywany – usuń go w pliku docker-compose.override.yml, jeśli wolisz). Wymagany jest PostgreSQL 16 lub nowszy, rola będąca właścicielem bazy oraz dostępne rozszerzenia pg_trgm i unaccent. Wystarczy wtedy sam obraz – zobacz Instalacja.