Mehrere Websites

Eine Docsello-Installation kann beliebig viele Workspaces bedienen – jeder mit eigener Website, eigener Domain, eigenen Mitgliedern, eigenem Single Sign-on und eigenen API-Tokens. So laufen zum Beispiel die Dokumentationen mehrerer Produkte auf einem Server.

Neuen Workspace anlegen#

1. Workspace erstellen#

   Als Betreiber in der Verwaltung oben über die Workspace-Auswahl Neuer Workspace wählen (oder /admin/new öffnen), Name und Adresse eingeben und Erstellen klicken. Der Workspace ist sofort unter <adresse>.<ROOT_DOMAIN> erreichbar.

2. Domain einrichten#

   DNS der gewünschten Domain (z. B. docs.example.org) auf den Server zeigen lassen.

   • Mit Caddy ist sonst nichts zu tun – das Zertifikat wird beim ersten Aufruf ausgestellt.
   • Hinter nginx brauchst du ein Zertifikat und eine nginx-Site für die Domain, z. B. mit certbot und einer Site nach dem Vorbild von deploy/nginx/docsello.conf (Details in docs/SERVER_INSTALL.md, Abschnitt „More sites on the same install“).

3. Domain im Workspace verbinden#

   Im neuen Workspace unter Startseite → Domains die Domain hinzufügen und Prüfen, siehe Domains.

4. Anmeldung und Tokens#

   Unter Einstellungen den Anmelde-Anbieter einrichten (Redirect-URI https://docs.example.org/auth/oidc/callback) und unter API & Tokens einen eigenen Token für die CI anlegen.

Wer darf Workspaces anlegen?#

Standardmäßig nur der Betreiber – das erste Konto der Installation. Mit DOCSELLO_OPEN_SIGNUP=1 darf sich jeder registrieren und eigene Workspaces anlegen (für gehostete Angebote, siehe Konfiguration).

Wie die Domains zugeordnet werden#

Nach jedem Veröffentlichen verknüpft der Worker jede verifizierte Domain einer Website mit ihrem Ordner im Speicher. Der Webserver liefert die Seiten dann direkt von der Festplatte aus. Eine gerade erst hinzugefügte Domain funktioniert sofort über die Anwendung und wird nach dem nächsten Veröffentlichen ebenfalls direkt ausgeliefert. Wer das sofort möchte, erzeugt die Website neu: docker compose run --rm worker build-site.