Konfiguration

Alle Einstellungen stehen in der .env neben der docker-compose.yaml. Die Datei .env.production.example, die install.sh mitbringt, ist die Referenz: Jede Einstellung hat dort einen Standardwert oder ist als REQUIRED markiert.

docker compose up -d

Was Du selbst setzen musst

install.sh erzeugt APP_KEY, DB_PASSWORD, MEILISEARCH_KEY und HEALTH_TOKEN und trägt Version und Adresse ein. Übrig bleiben drei Angaben:

Mailversand

Jede Mail des Nusszopf (Willkommen, Bestätigung, Passwort zurücksetzen, Kontaktformular, Newsletter-Bestätigungen) wird in die Warteschlange gelegt und vom queue-worker verschickt. Der Nusszopf benutzt dafür Laravels Mailer und fügt nichts hinzu. Du wählst mit MAIL_MAILER einen aus und gibst seine Zugangsdaten an.

Resend ist die Empfehlung. Es ist der Anbieter, mit dem echte Zustellung an ein fremdes Postfach auf dem Produktions-Stack geprüft wurde, und es braucht eine einzige Einstellung. Ein SMTP-Relay funktioniert über denselben Mechanismus, wurde aber nur gegen einen Test-Mailserver ohne Zertifikatsprüfung getestet, nicht gegen ein echtes Relay mit TLS.

# Resend (empfohlen)
MAIL_MAILER=resend
RESEND_API_KEY=re_…
MAIL_FROM_ADDRESS=hallo@nusszopf.example.org

# SMTP-Relay
MAIL_MAILER=smtp
MAIL_HOST=smtp.example.org
MAIL_PORT=587          # 587 mit STARTTLS, 465 mit implizitem TLS
MAIL_USERNAME=…
MAIL_PASSWORD=…
MAIL_SCHEME=smtps      # nur bei Port 465 nötig
MAIL_FROM_ADDRESS=hallo@nusszopf.example.org

Zwei Regeln sind wichtig:

• Die Absenderdomain muss bei Deinem Anbieter verifiziert sein. Resend lehnt jede andere Domain ab (The <domain> domain is not verified); die Mail landet dann nach fünf Versuchen in failed_jobs. Welche DNS-Einträge nötig sind (DKIM, ein Return-Path, meist auch SPF und DMARC), sagt Dein Anbieter.
• Zertifikate werden immer geprüft. Es gibt keine Einstellung, das abzuschalten.

Alle Mails sind reines HTML ohne Text-Teil. Das ist gewollt, keine Fehlkonfiguration. Wie die Mails in Gmail, Outlook und Apple Mail aussehen, ist noch nicht geprüft; in Proton Mail schon.

Wenn Du einen no-reply@-Absender benutzt, setze zusätzlich NUSSZOPF_CONTACT_EMAIL auf ein Postfach, das Du liest. Sonst verweisen Fehlerseite, Kontaktkarte und Mail-Fußzeilen Menschen auf die no-reply-Adresse. Mails des Kontaktformulars tragen die Adresse der Absender:innen als Reply-To, „Antworten“ funktioniert also in jedem Fall.

Rechtstexte

Impressum (/legalNotice), Rechtliches (/legalPolicy) und Datenschutz (/privacy) zeigen Deinen Text. Der Nusszopf liefert keinen mit. Lege drei Markdown-Dateien in den Ordner legal/ neben der docker-compose.yaml; install.sh legt ihn an, der Stack bindet ihn schreibgeschützt ein.

Die Überschrift der Seite ist fest, die Datei liefert den Inhalt: ##-Überschriften, Absätze, Listen und Links; ein Zeilenende mit zwei Leerzeichen erzwingt einen Umbruch. Rohes HTML wird als Text angezeigt. Änderungen erscheinen beim nächsten Aufruf, ohne Neustart. Fehlt eine Datei oder ist sie leer, steht auf der Seite „Dieser Text wurde von den Betreiber:innen dieser Nusszopf-Instanz noch nicht hinterlegt.“

Als Vorlage dienen die Texte des ursprünglichen Betreibers unter docs/deployment/legal-examples/. Veröffentliche sie nicht unverändert. Dein Datenschutztext muss beschreiben, was Deine Instanz wirklich tut: welchen Mailanbieter Du benutzt, ob LocationIQ und Google-Login aktiv sind und dass der Newsletter ein Double-Opt-in hat. Ändert er sich, erhöhe NEWSLETTER_CONSENT_VERSION (siehe Newsletter). Sichere den Ordner zusammen mit der .env.

Ortssuche (LocationIQ)

Wer ein Projekt an einen Ort bindet („Ortsgebunden“), sucht ihn über die Autocomplete-API von LocationIQ, wie im ursprünglichen Nusszopf, und zwar nur deutsche Städte, Gemeinden und Dörfer. Es gibt einen kostenlosen Tarif. Trage den Schlüssel als LOCATIONIQ_KEY ein. Die Anfrage stellt der Server, der Schlüssel gelangt nie in den Browser.

Ohne Schlüssel zeigt die Ortssuche keine Vorschläge, und ein Projekt lässt sich nicht an einen Ort binden. „Ortsunabhängige“ Projekte sind nicht betroffen.

Google-Login

Der Login mit Google braucht einen OAuth-2.0-Client aus der Google Cloud Console. Trage als autorisierte Weiterleitungs-URI <APP_URL>/auth/google/callback ein und setze GOOGLE_CLIENT_ID und GOOGLE_CLIENT_SECRET. Fehlt eine der beiden Angaben, verschwindet der Google-Knopf, die Routen antworten mit 404, und der Login per Name oder E-Mail ist davon nicht berührt. GOOGLE_REDIRECT_URI brauchst Du nur, wenn die Instanz unter einer anderen Adresse als APP_URL erreichbar ist.

Alle Einstellungen

Fett sind die, die Du setzen musst; install.sh füllt die mit „erzeugt“.

LOCATIONIQ_URL und MAIL_SCHEME liest die Anwendung ebenfalls, sie stehen aber nicht in der Vorlage. Die erste ist für einen kompatiblen Ersatzdienst gedacht, die zweite für SMTP über Port 465.

Weiter

• Die Instanz läuft und ist konfiguriert? Dann sichere sie: Backup und Wiederherstellung.
• Eine neue Version einspielen: Deployment.