diff --git a/src/content/docs/en/selbst-hosten/index.mdx b/src/content/docs/en/selbst-hosten/index.mdx
index 5f8d16a..8395ba4 100644
--- a/src/content/docs/en/selbst-hosten/index.mdx
+++ b/src/content/docs/en/selbst-hosten/index.mdx
@@ -60,8 +60,8 @@ For the vast majority of installations, `single` is right. The data is the same
- **`DOMAIN`** – your domain without `https://`, e.g. `basar.example.org`
- **`POSTGRES_PASSWORD`** – a random password for the database, e.g. generated with `openssl rand -hex 24`. Set it once and don't change it afterwards: the database takes it over on the first start.
- - **`ACME_EMAIL`** – your email address; Let's Encrypt warns you there about expiring certificates
- - **`BAZARPRO_VERSION`** – the version you want to install, at least `v2.0.0`. All versions are listed under [Releases](https://github.com/BazarPro/core/releases).
+ - **`ACME_EMAIL`** – your real email address; Let's Encrypt warns you there about expiring certificates. Let's Encrypt rejects `example.org` addresses like the one in the template, and you then get no certificate.
+ - **`BAZARPRO_VERSION`** – the version you want to install. A new installation needs at least `v2.3.0`: older versions don't create any categories, and without categories no bazaar can be created. All versions are listed under [Releases](https://github.com/BazarPro/core/releases).
- **`BAZARPRO_MODE`** – `single` for one association (default) or `platform`, see above
- **`ADMIN_EMAIL`** – the email address you'll sign up with in a moment. This account automatically becomes administrator.
- **`AUTH_SMTP_…`** and **`AUTH_EMAIL_FROM`** – the credentials of your email account. The address in `AUTH_EMAIL_FROM` must match this account, otherwise the emails end up in spam. In `single` mode, BazarPro uses your association's name from the settings as the sender name.
@@ -78,7 +78,7 @@ For the vast majority of installations, `single` is right. The data is the same
docker compose -f docker-compose.selfhost.yml logs -f backend
```
- As soon as it says **`listening`**, BazarPro is ready.
+ As soon as it says **`listening`**, the backend is ready. The website starts after that. If the browser shows `404 page not found` or a certificate warning during the first few seconds, reload the page shortly afterwards.
5. **Create your account.** Open your domain in the browser, click **Sign up** – with the address from `ADMIN_EMAIL` – and confirm it with the code from the confirmation email. As soon as the address is confirmed, your account is administrator. After reloading the page, you find the **Admin** area in the role switcher in the sidebar.
@@ -98,9 +98,76 @@ For the vast majority of installations, `single` is right. The data is the same
- Check that your domain points to the server, e.g. with `dig +short basar.example.org`.
- Let's Encrypt checks the domain via port 80. A firewall must not block it.
- Errors while fetching certificates are shown by `docker compose -f docker-compose.selfhost.yml logs traefik`.
+ - If you keep getting `404 page not found`, the address you opened doesn't match `DOMAIN` in the `.env`. Via the server's IP address or `localhost` this message is normal, because Traefik only answers on the configured domain.
- If the backend doesn't start, `docker compose -f docker-compose.selfhost.yml logs backend` shows why.
+## Your own reverse proxy instead of Traefik
+
+If your server already runs a reverse proxy such as Caddy, it occupies ports 80 and 443. BazarPro then works without Traefik. Your proxy takes care of HTTPS and forwards `/api` to the backend and everything else to the app. You don't change the `docker-compose.selfhost.yml` for this.
+
+
+
+1. **Create a second Compose file.** If your proxy runs in Docker itself, create a `docker-compose.proxy.yml` next to the `docker-compose.selfhost.yml`:
+
+ ```yaml
+ services:
+ app:
+ networks:
+ default:
+ proxy:
+ aliases: [bazarpro-app]
+ backend:
+ networks:
+ default:
+ proxy:
+ aliases: [bazarpro-backend]
+
+ networks:
+ proxy:
+ external: true
+ name: caddy_default # your proxy's network
+ ```
+
+ Enter your proxy's network under `name`; `docker network ls` lists all networks. Be sure to keep `default` in the list: without that network the backend can't find the database and stops with `failed to lookup address information`. You don't need fixed container names.
+
+2. **Start BazarPro without Traefik.** Fill in the `.env` as described above. `ACME_EMAIL` must be set but isn't used.
+
+ ```bash
+ docker compose -f docker-compose.selfhost.yml -f docker-compose.proxy.yml up -d app backend postgres
+ ```
+
+3. **Set up the proxy.** For Caddy it looks like this:
+
+ ```
+ basar.example.org {
+ reverse_proxy /api/* bazarpro-backend:3000
+ reverse_proxy bazarpro-app:8080
+ }
+ ```
+
+ With other proxies you have to enable WebSockets for `/api`, otherwise live updates won't work. Caddy does this on its own.
+
+
+
+If your proxy runs directly on the server and not in Docker, the `docker-compose.proxy.yml` looks like this instead:
+
+```yaml
+services:
+ app:
+ ports:
+ - '127.0.0.1:8080:8080'
+ backend:
+ ports:
+ - '127.0.0.1:3000:3000'
+```
+
+Your proxy then forwards to `127.0.0.1:3000` (`/api`) and `127.0.0.1:8080` (everything else). If one of the ports is taken, change the first number.
+
+
+
## After the installation: set up your association
Before you create the first bazaar, set up two things as an administrator:
@@ -124,6 +191,8 @@ Before you create the first bazaar, set up two things as an administrator:
The templates for privacy policy and terms come from the bazarpro.de platform and are written in German for German law. They must be adapted to your association – the terms, for example, because your association is the organizer itself. Have the texts checked legally before publishing.
+The **categories** that bazaars and items choose from are already there. You can change and extend them under **Admin › Categories**.
+
Then, in the **Organizer** role, create your first bazaar, see [Create a bazaar](/en/veranstalter/basar-anlegen/). In `single` mode, a public bazaar is visible immediately; no approval is needed.
BazarPro shows the app in German or English depending on the visitor's browser; everyone can switch the language themselves.
@@ -132,7 +201,7 @@ BazarPro shows the app in German or English depending on the visitor's browser;
BazarPro can count visitors with [Plausible Analytics](https://plausible.io) – without cookies. Plausible isn't included in BazarPro: you need your own Plausible installation ([Community Edition](https://github.com/plausible/community-edition)) or an account at plausible.io.
-Turn web analytics on under **Admin › Settings › Web analytics with Plausible**: enter the domain and Plausible server, activate, save. No restart needed. Alternatively, you can set `PLAUSIBLE_DOMAIN` and `PLAUSIBLE_API_HOST` in the `.env`. The settings in the admin area take precedence.
+Turn web analytics on under **Admin › Settings › Web analytics with Plausible**: enter the domain and Plausible server, activate, save. No restart needed. Alternatively, you can set `PLAUSIBLE_DOMAIN` and `PLAUSIBLE_API_HOST` in the `.env`. The settings in the admin area take precedence. Web analytics only runs when both values are known.
If your privacy policy contains the line `{{webanalyse}}` (the template includes it), BazarPro automatically inserts a section about Plausible there while web analytics is active. If you use plausible.io, you also need a data processing agreement with the provider.
diff --git a/src/content/docs/selbst-hosten/index.mdx b/src/content/docs/selbst-hosten/index.mdx
index bfc6d75..60f4e7e 100644
--- a/src/content/docs/selbst-hosten/index.mdx
+++ b/src/content/docs/selbst-hosten/index.mdx
@@ -60,8 +60,8 @@ Für die allermeisten Installationen ist `single` richtig. Die Daten sind in bei
- **`DOMAIN`** – deine Domain ohne `https://`, z. B. `basar.example.org`
- **`POSTGRES_PASSWORD`** – ein zufälliges Passwort für die Datenbank, z. B. erzeugt mit `openssl rand -hex 24`. Lege es einmal fest und ändere es danach nicht mehr: Die Datenbank übernimmt es beim ersten Start.
- - **`ACME_EMAIL`** – deine E-Mail-Adresse, Let's Encrypt warnt dich dort vor ablaufenden Zertifikaten
- - **`BAZARPRO_VERSION`** – die Version, die du installieren möchtest, mindestens `v2.0.0`. Alle Versionen findest du unter [Releases](https://github.com/BazarPro/core/releases).
+ - **`ACME_EMAIL`** – deine echte E-Mail-Adresse, Let's Encrypt warnt dich dort vor ablaufenden Zertifikaten. Adressen mit `example.org` wie in der Vorlage lehnt Let's Encrypt ab, dann gibt es kein Zertifikat.
+ - **`BAZARPRO_VERSION`** – die Version, die du installieren möchtest. Für eine neue Installation brauchst du mindestens `v2.3.0`: Ältere Versionen legen keine Kategorien an, und ohne Kategorien lässt sich kein Basar erstellen. Alle Versionen findest du unter [Releases](https://github.com/BazarPro/core/releases).
- **`BAZARPRO_MODE`** – `single` für einen Verein (Standard) oder `platform`, siehe oben
- **`ADMIN_EMAIL`** – die E-Mail-Adresse, mit der du dich gleich registrierst. Dieses Konto wird automatisch Administrator.
- **`AUTH_SMTP_…`** und **`AUTH_EMAIL_FROM`** – die Zugangsdaten deines E-Mail-Postfachs. Die Adresse in `AUTH_EMAIL_FROM` muss zu diesem Postfach passen, sonst landen die Mails im Spam. Als Absendername verwendet BazarPro im Modus `single` den Namen deines Vereins aus den Einstellungen.
@@ -78,7 +78,7 @@ Für die allermeisten Installationen ist `single` richtig. Die Daten sind in bei
docker compose -f docker-compose.selfhost.yml logs -f backend
```
- Sobald dort **`listening`** steht, ist BazarPro bereit.
+ Sobald dort **`listening`** steht, ist das Backend bereit. Danach startet noch die Webseite. Zeigt der Browser in den ersten Sekunden `404 page not found` oder eine Zertifikatswarnung, lade die Seite nach kurzer Zeit neu.
5. **Konto anlegen.** Öffne deine Domain im Browser, klicke auf **Registrieren** – mit der Adresse aus `ADMIN_EMAIL` – und bestätige sie mit dem Code aus der Bestätigungsmail. Sobald die Adresse bestätigt ist, ist dein Konto Administrator. Nach einem Neuladen der Seite findest du im Rollenwechsel der Seitenleiste den Bereich **Admin**.
@@ -98,9 +98,76 @@ Für die allermeisten Installationen ist `single` richtig. Die Daten sind in bei
- Prüfe, ob deine Domain auf den Server zeigt, z. B. mit `dig +short basar.example.org`.
- Let's Encrypt prüft die Domain über Port 80. Eine Firewall darf ihn nicht blockieren.
- Fehlermeldungen beim Holen der Zertifikate zeigt `docker compose -f docker-compose.selfhost.yml logs traefik`.
+ - Bleibt es bei `404 page not found`, stimmt die aufgerufene Adresse nicht mit `DOMAIN` aus der `.env` überein. Über die IP-Adresse des Servers oder über `localhost` ist diese Meldung normal, denn Traefik antwortet nur auf die eingetragene Domain.
- Startet das Backend nicht, steht der Grund in `docker compose -f docker-compose.selfhost.yml logs backend`.
+## Eigener Reverse Proxy statt Traefik
+
+Läuft auf deinem Server schon ein Reverse Proxy wie Caddy, belegt er die Ports 80 und 443. BazarPro kommt dann ohne Traefik aus. Dein Proxy kümmert sich um HTTPS und leitet `/api` an das Backend und alles andere an die App weiter. Die `docker-compose.selfhost.yml` änderst du dafür nicht.
+
+
+
+1. **Zweite Compose-Datei anlegen.** Lege neben der `docker-compose.selfhost.yml` eine `docker-compose.proxy.yml` an, wenn dein Proxy selbst in Docker läuft:
+
+ ```yaml
+ services:
+ app:
+ networks:
+ default:
+ proxy:
+ aliases: [bazarpro-app]
+ backend:
+ networks:
+ default:
+ proxy:
+ aliases: [bazarpro-backend]
+
+ networks:
+ proxy:
+ external: true
+ name: caddy_default # Netzwerk deines Proxys
+ ```
+
+ Trage bei `name` das Netzwerk deines Proxys ein, `docker network ls` zeigt alle Netzwerke. Lass `default` unbedingt in der Liste stehen: Ohne das Netzwerk findet das Backend die Datenbank nicht und bricht mit `failed to lookup address information` ab. Feste Containernamen brauchst du nicht.
+
+2. **BazarPro ohne Traefik starten.** Die `.env` füllst du aus wie oben. `ACME_EMAIL` muss gesetzt sein, wird aber nicht benutzt.
+
+ ```bash
+ docker compose -f docker-compose.selfhost.yml -f docker-compose.proxy.yml up -d app backend postgres
+ ```
+
+3. **Proxy einrichten.** Für Caddy sieht das so aus:
+
+ ```
+ basar.example.org {
+ reverse_proxy /api/* bazarpro-backend:3000
+ reverse_proxy bazarpro-app:8080
+ }
+ ```
+
+ Bei anderen Proxys musst du WebSockets für `/api` einschalten, sonst funktionieren die Live-Updates nicht. Caddy macht das von selbst.
+
+
+
+Läuft dein Proxy direkt auf dem Server und nicht in Docker, sieht die `docker-compose.proxy.yml` stattdessen so aus:
+
+```yaml
+services:
+ app:
+ ports:
+ - '127.0.0.1:8080:8080'
+ backend:
+ ports:
+ - '127.0.0.1:3000:3000'
+```
+
+Dein Proxy leitet dann an `127.0.0.1:3000` (`/api`) und `127.0.0.1:8080` (alles andere) weiter. Ist einer der Ports belegt, ändere die erste Zahl.
+
+
+
## Nach der Installation: deinen Verein einrichten
Bevor du den ersten Basar anlegst, richte als Administrator zwei Dinge ein:
@@ -124,13 +191,15 @@ Bevor du den ersten Basar anlegst, richte als Administrator zwei Dinge ein:
Die Vorlagen für Datenschutzerklärung und AGB stammen von der Plattform bazarpro.de. Sie müssen an deinen Verein angepasst werden – die AGB zum Beispiel, weil ihr als Verein selbst Veranstalter seid. Lass die Texte vor der Veröffentlichung rechtlich prüfen.
+Die **Kategorien**, aus denen Basare und Artikel wählen, sind schon angelegt. Unter **Admin › Kategorien** kannst du sie ändern und ergänzen.
+
Danach legst du unter der Rolle **Veranstalter** deinen ersten Basar an, siehe [Einen Basar anlegen](/veranstalter/basar-anlegen/). Im Modus `single` ist ein öffentlicher Basar sofort sichtbar, eine Freigabe ist nicht nötig.
## Webanalyse mit Plausible (optional)
BazarPro kann die Besucherzahlen mit [Plausible Analytics](https://plausible.io) erfassen – ohne Cookies. Plausible ist nicht in BazarPro enthalten: Du brauchst eine eigene Plausible-Installation ([Community Edition](https://github.com/plausible/community-edition)) oder ein Konto bei plausible.io.
-Eingeschaltet wird die Webanalyse unter **Admin › Einstellungen › Webanalyse mit Plausible**: Domain und Plausible-Server eintragen, aktivieren, speichern. Ein Neustart ist nicht nötig. Alternativ kannst du `PLAUSIBLE_DOMAIN` und `PLAUSIBLE_API_HOST` in der `.env` setzen. Die Einstellungen im Admin-Bereich haben Vorrang.
+Eingeschaltet wird die Webanalyse unter **Admin › Einstellungen › Webanalyse mit Plausible**: Domain und Plausible-Server eintragen, aktivieren, speichern. Ein Neustart ist nicht nötig. Alternativ kannst du `PLAUSIBLE_DOMAIN` und `PLAUSIBLE_API_HOST` in der `.env` setzen. Die Einstellungen im Admin-Bereich haben Vorrang. Die Webanalyse läuft nur, wenn beide Werte bekannt sind.
Steht in deiner Datenschutzerklärung die Zeile `{{webanalyse}}` (in der Vorlage ist sie enthalten), fügt BazarPro dort automatisch einen Abschnitt zu Plausible ein, solange die Webanalyse aktiv ist. Nutzt du plausible.io, brauchst du zusätzlich einen Vertrag zur Auftragsverarbeitung mit dem Anbieter.