> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Notifuse auf Ihrem Server betreiben

> In etwa 15 Minuten starten Sie Notifuse mit Docker Compose, schließen den Einrichtungsassistenten ab, legen einen Arbeitsbereich an und senden eine Test-E-Mail.

Am Ende läuft Notifuse auf Ihrem Server, und Sie haben ein Administratorkonto, einen Arbeitsbereich und einen E-Mail-Anbieter, der Ihnen eine Test-E-Mail geschickt hat.

## Bevor Sie beginnen

- Ein Server mit Docker Engine 25.0 oder neuer und Docker Compose v2.24 oder neuer. Prüfen Sie das mit `docker compose version`.
- Port 8081 muss von Ihrem Browser aus erreichbar sein. Dort stellt Notifuse die Konsole und die API bereit.
- Ein SMTP-Server für die E-Mails der Instanz selbst: Anmeldecodes und Einladungen. Ohne ihn können Sie sich nicht anmelden.
- Zugangsdaten für den E-Mail-Anbieter, über den Ihr Arbeitsbereich senden wird: ein SMTP-Server oder ein Amazon-SES-Konto mit verifiziertem Absender. Es kann derselbe SMTP-Server sein.

## Installieren und senden

### 1. Compose-Datei herunterladen und .env anlegen

Führen Sie Folgendes in einem leeren Verzeichnis aus:

```bash
mkdir notifuse && cd notifuse
curl -fsSL https://raw.githubusercontent.com/Notifuse/notifuse/main/compose.yaml -o compose.yaml

test -e .env || cat > .env <<EOF
SECRET_KEY=$(openssl rand -base64 32)
DB_PASSWORD=$(openssl rand -hex 24)
EOF
```

`SECRET_KEY` verschlüsselt Ihre gespeicherten Daten. Compose startet ohne ihn nicht, und Notifuse lehnt einen Schlüssel ab, der kürzer als 32 Byte ist. Bewahren Sie eine Kopie der Datei `.env` auf: Mit einem neuen Schlüssel sind Ihre gespeicherten Daten nicht mehr lesbar.

`DB_PASSWORD` ist das PostgreSQL-Passwort. Fehlt es, verwendet die Datenbank `postgres`.

> [!WARNING]
>
> Compose benennt das Datenbank-Volume nach diesem Verzeichnis. Behalten Sie den Namen bei: In einem umbenannten oder verschobenen Verzeichnis startet `docker compose up -d` eine neue Installation mit leerer Datenbank.

### 2. Notifuse starten

```bash
docker compose up -d
```

Damit wird das Notifuse-Image heruntergeladen und mit einer eigenen PostgreSQL-Datenbank gestartet. Konsole und API lauschen auf Port 8081. PostgreSQL ist nur vom Server selbst aus erreichbar, unter `127.0.0.1:5433`.

Um das Serverprotokoll zu verfolgen, führen Sie `docker compose logs -f api` aus.

> [!WARNING]
>
> Notifuse liefert reines HTTP aus. Bevor Sie eine Domain darauf zeigen lassen, schalten Sie einen Reverse Proxy mit TLS davor. Läuft dieser Proxy auf demselben Server, setzen Sie `HTTP_BIND=127.0.0.1` in `.env`, damit Port 8081 nur auf dem Server selbst antwortet, und führen Sie `docker compose up -d` erneut aus. [Installation](https://www.notifuse.com/de/docs/self-hosting/installation.md) behandelt das und alles Weitere: Umgebungsvariablen, Docker ohne Compose, Updates und den geheimen Schlüssel.

### 3. Einrichtungsassistenten ausfüllen

Öffnen Sie `http://<server>:8081`. Bis die Einrichtung abgeschlossen ist, führt jede Seite zum Assistenten **Richten Sie Ihre Notifuse-Instanz ein**. Er besteht aus einer Seite mit fünf Bereichen:

1. **Administrator**: eine oder mehrere Adressen unter **Root-E-Mail**, die sich als Root anmelden, und der **API-Endpunkt**, vorausgefüllt mit der Adresse der Seite. Behalten Sie diese Adresse vorerst bei: Den späteren Umzug auf Ihre HTTPS-Domain beschreibt [Domain ändern](https://www.notifuse.com/de/docs/self-hosting/changing-domain.md).
2. **Versand von System-E-Mails (SMTP)**: **Host**, **Port** (standardmäßig 587), **TLS verwenden**, **Benutzername**, **Passwort**, **Absender-E-Mail** und **Absendername**. Notifuse nutzt diesen Server nur für Anmeldecodes und Einladungen. Klicken Sie auf **Verbindung testen**, um ihn zu prüfen.
3. **Updates und Telemetrie**: beide sind standardmäßig eingeschaltet. Schalten Sie sie bei Bedarf aus.
4. **Single Sign-on (OpenID Connect)**: optional. Überspringen Sie es vorerst.
5. **SMTP-Bridge**: optional. Überspringen Sie sie vorerst.

Eine Einstellung, die Sie bereits in `.env` gesetzt haben, erscheint gesperrt, mit dem Namen ihrer Variablen.

Klicken Sie auf **Einrichtung abschließen**. Der Server startet neu, um die Konfiguration zu übernehmen, was meist einige Sekunden dauert. Sobald **Notifuse ist bereit** erscheint, klicken Sie auf **Zur Anmeldung**.

![Der Einrichtungsassistent: Administrator, Versand von System-E-Mails, Updates und Telemetrie, Single Sign-on und SMTP-Bridge](https://www.notifuse.com/docs/assets/screenshots/setup.png)

### 4. Anmelden

Geben Sie die erste Root-E-Mail ein und klicken Sie auf **Magic-Code senden**. Der Code kommt über den SMTP-Server, den Sie im Assistenten eingetragen haben. Geben Sie den 6-stelligen Code ein und klicken Sie auf **Code verifizieren**.

Kommt kein Code an, sind die SMTP-Einstellungen des Systems falsch. Prüfen Sie das Serverprotokoll mit `docker compose logs -f api`.

### 5. Arbeitsbereich anlegen

Die Einrichtung legt keinen Arbeitsbereich an, deshalb öffnet die Konsole die Seite **Neuer Arbeitsbereich**.

- **Arbeitsbereichsname**: 3 bis 32 Zeichen.
- **Arbeitsbereich-ID**: wird aus dem Namen erzeugt. Sie darf nur Kleinbuchstaben und Ziffern enthalten, höchstens 20 Zeichen, und erscheint in URLs und API-Anfragen.
- **Website-URL**: optional. Notifuse ermittelt darüber Ihr Favicon.

Klicken Sie auf **Arbeitsbereich erstellen**. Der Arbeitsbereich enthält bereits einen Kontakt für Sie und eine Liste namens **Test List**, die Sie abonniert haben. Nur ein Root-Benutzer kann Arbeitsbereiche anlegen, und eine Installation ohne [Lizenz](https://www.notifuse.com/de/docs/self-hosting/licence.md) kann drei haben.

### 6. E-Mail-Anbieter verbinden

Der System-SMTP-Server aus dem Assistenten versendet keine E-Mails der Arbeitsbereiche. Jeder Arbeitsbereich verbindet seinen eigenen Anbieter.

Gehen Sie zu **Einstellungen** und dann unter **Versand** zu **Integrationen**. Klicken Sie auf **Integration hinzufügen** und wählen Sie Ihren Anbieter in der Gruppe **E-Mail-Versand**.

Bei jedem Anbieter füllen Sie **Name** aus, geben mindestens einen Absender an (**Absender hinzufügen** fragt nach **E-Mail** und **Name**) und legen eine **Rate für Marketing** in E-Mails pro Minute fest, standardmäßig 25. Danach füllen Sie die Felder des jeweiligen Anbieters aus:

**SMTP**

- **Host**: der Name Ihres SMTP-Servers.
- **Port**: 587 für STARTTLS, 465 für TLS ab dem ersten Byte, 25 unverschlüsselt.
- **Verschlüsselung**: Lassen Sie **TLS verwenden** eingeschaltet, außer Ihr Server akzeptiert nur Klartext.
- **EHLO-Hostname**: optional. Standardmäßig der Host.
- **Methode**: **Benutzername und Passwort** oder **OAuth2** für ein Postfach bei Microsoft 365 oder Google Workspace.
- **Benutzername** und **Passwort**: Lassen Sie beide leer, wenn Ihr Server E-Mails ohne Anmeldung annimmt.

OAuth2 und gängige Server beschreibt [SMTP](https://www.notifuse.com/de/docs/integrations/smtp.md).

**Amazon SES**

- **Region**: die AWS-Region, in der Ihre verifizierten Identitäten liegen.
- **Zugriffsschlüssel-ID** und **Geheimer Zugriffsschlüssel**: die eines IAM-Benutzers, der über SES senden darf.
- **Mandantenisolierung**: optional. Der Arbeitsbereich erhält damit eine eigene SES-Reputation und eine eigene Sperrliste, und AWS rechnet pro Mandant ab.
- **Erweitert**: **Konfigurationssatz** und **SES-Mandant**, für Namen, die Sie selbst in AWS verwalten. Lassen Sie beide leer.

Die IAM-Berechtigungen beschreibt [Amazon SES](https://www.notifuse.com/de/docs/integrations/amazon-ses.md).

Klicken Sie auf **Speichern**. Bei jedem Anbieter außer SMTP registriert Notifuse anschließend dort Webhooks, die auf Ihren API-Endpunkt zeigen. So erfährt Notifuse von Zustellungen, Bounces und Beschwerden. Zeigt die Karte **Webhooks nicht registriert**, klicken Sie in ihrem Menü auf **Webhooks registrieren**, sobald die Instanz unter ihrer öffentlichen Adresse antwortet.

### 7. Festlegen, was der Anbieter sendet

Ein neuer Anbieter sendet nichts, bis Sie ihm eine Rolle geben. Wählen Sie ihn im Bereich **E-Mail-Versand** für **Marketing-E-Mails** (Kampagnen und E-Mails aus Automatisierungen) und für **Transaktionale E-Mails** (Benachrichtigungen, die über die API, Zapier oder Supabase gesendet werden). Bestätigen Sie jede Änderung mit **Ja**.

Das Menü der Anbieterkarte bietet dieselben Optionen: **Für Marketing verwenden** und **Für Transaktionales verwenden**.

![Der Bereich E-Mail-Versand mit einem Anbieter für Marketing- und transaktionale E-Mails, darunter die Anbieterkarte](https://www.notifuse.com/docs/assets/screenshots/integrations_email_sending.png)

### 8. Test senden

Klicken Sie auf der Anbieterkarte auf **Test senden**. Geben Sie unter **Senden an** Ihre Adresse ein und klicken Sie auf **Test-E-Mail senden**.

## Prüfen, ob es funktioniert

- Die Test-E-Mail liegt in Ihrem Posteingang. Falls nicht, sehen Sie im Spam-Ordner nach und prüfen Sie dann die Zugangsdaten des Anbieters und die Absenderadresse.
- Im Bereich **E-Mail-Versand** zeigt keine der beiden Rollen **Nicht festgelegt**.
- `docker compose ps` listet die Dienste `api` und `postgres` als laufend auf.

## Nächste Schritte

> [card] [Checkliste für den Produktivbetrieb](https://www.notifuse.com/de/docs/self-hosting/production-checklist.md)
>
> Was Sie prüfen sollten, bevor die Instanz echten Traffic verarbeitet.

> [card] [So greift Notifuse ineinander](https://www.notifuse.com/de/docs/concepts.md)
>
> Arbeitsbereiche, Kontakte, Listen, Segmente und die drei Versandwege.

> [card] [Ihre erste Kampagne senden](https://www.notifuse.com/de/docs/features/broadcast-campaigns.md)
>
> Schreiben Sie eine Kampagne und senden Sie sie an eine Liste. Die **Test List** ist eine sichere erste Zielgruppe.
