try to reproduce build steps in local web: trying to get a small webserver running to which the make steps can push.

This commit is contained in:
entsteuerung 2023-06-01 15:59:55 +02:00
parent d94a133a81
commit 4d796b9db7
221 changed files with 4094 additions and 0 deletions

View file

@ -0,0 +1,20 @@
---
title: "Mailinglisten"
date: 2022-11-04T21:08:25+01:00
geekdocCollapseSection: true
---
Mailinglisten - was ist denn das? Kurz gesagt: anstatt eine Mail an eine große Anzahl von Adressen zu schicken, kannst du einfach eine Mail an die Adresse der Mailingliste schreiben - diese wird dann an alle sogenannten Abonnent:innen weitergeleitet. Dies ist sinnvoll, wenn eine Gruppe von Menschen per Mail miteinander kommunizieren möchte.
## Arten von Mailinglisten
Es gibt verschiedene Arten von Mailinglisten:
| Art | Eigenschaft |
|-----|-------------|
| Öffentlich | Jede:r kann sich einschreiben und anschließend Mails an alle anderen Abonnent:innen schicken |
| Zugangsbeschränkt | Die Einschreibung wird durch eine:n Moderator:in akzeptiert oder abgelehnt |
| Newsletter | Nur ausgewählte Nutzer:innen können Mails über die Mailingliste an alle Abonnent:innen senden |
| Moderiert | Ein:e Moderator:in kann die Weiterleitung eingehender Mails an alle Abonnent:innen akzeptieren oder ablehnen |
| Verschlüsselt | Eine zugangsbeschränte Liste, die verschlüsselte Mails empfängt und an alle Abonnent:innen verschlüsselt weiterleitet |
Darüber hinaus lassen sich auch verschiedene Arten miteinander kombinierten. Bspw. halb-öffentliche Listen, bei denen die Einschreibung moderiert ist, aber auch Nicht-Abonnent:innen E-Mails einsenden können.

View file

@ -0,0 +1,18 @@
---
title: "Verschlüsselte Listen"
date: 2022-11-04T21:09:08+01:00
geekdocCollapseSection: true
---
Du kannst auf systemausfall.org auch verschlüsselte Mailinglisten nutzen. Da wir dafür eine andere [Software](https://schleuder.org) einsetzen, unterscheiden sich die Listen in einigen Details von den unverschlüsselten Listen. Bevor du mit einer verschlüsselten Liste startest, möchten wir dir unsere Anleitungen zum sicheren Kommunizieren empfehlen.
Schaue dir gerne die [Doku](https://www.nadir.org/news/schleuderdoku.html) bei unseren Freund:innen von [Nadir](https://nadir.org) an.
## Funktionsweise
Die Liste besitzt ein eigenes GPG-Schlüsselbund mit privatem und öffentlichen Schlüssel. Beide werden auf unserem Mailserver gespeichert. Die E-Mails an die Liste werden mit dem öffentlichen Schlüssel der Liste verschlüsselt. Auf unserem Mailserver angekommen, entschlüsselt die Mailinglisten-Software die E-Mail automatisch mit dem zugehörigen privaten Schlüssel der Liste und verschlüsselt die E-Mail anschließend erneut mit allen in die Liste eingetragenen öffentlichen Schlüsseln der Abonnent:innen.
Auf der Projektseite der Listensoftware findest du eine schemenhafte Darstellung der [Funktionsweise](https://schleuder.org/schleuder/docs/concept.html).
## Sicherheitsaspekte
Bitte beachte, dass du auch mit einer verschlüsselten Mailinglisten nicht vollständig anonym kommunizierst. Die Meta-Daten deiner Kommunikation (Datum, Uhrzeit als auch der Betreff der E-Mail) sind weiterhin von außen einsehbar. Technisch ist es zudem möglich, dass jede verschlüsselte E-Mail auf unserem Mailserver gelesen werden kann (siehe Funktionsweise).

View file

@ -0,0 +1,21 @@
---
title: "FAQ"
date: 2022-11-15T08:49:00+01:00
---
## Weshalb werden meine E-Mail von der Liste abgewiesen?
Es kann vorkommen, dass Schleuder deine E-Mail an die Liste mit folgender Fehlermeldung ablehnt:
```Plain
The attached message was bounced with the following notice:
Only subscribed addresses may send messages to this address.
Kind regards,
Your Schleuder system.
```
Überprüfe zuerst, ob deine E-Mail-Adresse fehlerfrei eingetragen ist. Wenn dies der Fall ist, kann es daran liegen, dass die Absenderadresse deiner E-Mail Großbuchstaben enthält. Einige Mailserver achten auf die Groß- und Kleinschreibung von E-Mail-Adressen. Für diese Mailserver ist `name@example.org` eine andere Adresse als `Name@example.org`. Da Schleuder auf solche Gegebenheiten achten muss, werden E-Mails nur dann angenommen, wenn die Absenderadresse exakt der eingetragenen Schreibweise entspricht.
## Welche Bedeutung haben die Mails mit dem Betreff "keys updates"?
Die Listensoftware aktualisiert selbständig zugehörige GPG-Schlüssel über einen Keyserver. Das Ergebnis dieser Aktualisierung erhältst du dann per E-Mail mit dem Betreff *keys update*. Die Mail enhält eventuell die Ausgabe `gpg: keyserver refresh failed: Keine Daten`. Diese leider etwas missverständliche Meldung bedeutet, dass für einen Schlüssel keine Informationen auf dem benutzten Keyserver gefunden wurde.

View file

@ -0,0 +1,12 @@
---
title: "Eine Liste löschen"
date: 2022-11-11T12:03:05+01:00
---
Leider bietet die [Weboberfläche](https://nix.systemausfall.org) keine Möglichkeit, selbständig deine Liste zu löschen.
Insofern bitte wir dich folgende Schritte zu befolgen:
- [Schreibe](https://systemausfall.org/contact) und eine E-Mail von einer Adresse, die in der Liste als Admin eingetragen ist,
- Nennen und deinen Wunsch und den Namen der Liste.
Wir löschen die Liste und werden dich anschließend benachrichtigen.

View file

@ -0,0 +1,11 @@
---
title: "Neue Admins hinzufügen"
date: 2022-11-06T16:39:35+01:00
---
Du kannst beliebig vielen Personen die Rechte zur Verwaltung der Liste übertragen. Voraussetzung ist, dass die Person als Abonnenment eingetragen ist. So gehst du dafür vor:
- Wähle deine Liste aus.
- Klicke auf *Abos*.
- Wähle unter *Eingetragene Adressen* die Mailadresse der neuen Administratorin aus.
- Klicke rechts auf *Edit*.
- Aktiviere unter *Email* den Punkt *Admin?*.

View file

@ -0,0 +1,10 @@
---
title: "Neue Liste anlegen"
date: 2022-11-06T16:36:32+01:00
---
Jede neue Liste wird nach dem folgenden Muster angelegt:
```Plain
LISTENNAME@nix.systemausfall.org
```
Die [Verwaltungsoberfläche](https://nix.systemausfall.org) bietet für unsere Nutzer:innen leider keine Funktion, selbständig neue Listen anzulegen. Benutze deshalb bitte zum Anfragen einer neuen Liste unser [Formular](https://systemausfall.org/accounts_und_dienste).

View file

@ -0,0 +1,18 @@
---
title: "Verwaltung"
date: 2022-11-04T21:10:08+01:00
---
Die Verwaltung der Liste geht am einfachsten über unsere [Weboberfläche](https://nix.systemausfall.org). Bevor du deine Liste verwalten kannst, musst du dir dort ein Konto erstellen. Zusätzlich lässt sich deine Liste auch per E-Mail bedienen. Wie das geht, beschreibt die [Dokumentation](https://schleuder.org/schleuder/docs/list-admins.html) zur Listensoftware.
{{< hint title="Hinweis" >}}
Auch wenn du ein systemausfall.org-Konto hast, musst du dir in der Listenverwaltung einen Account erstellen, denn anders als sonst funktionieren deine Zugangsdaten hier nicht.
{{< /hint >}}
| Option | Beschreibung |
|--------|--------------|
| Verwaltungsoberfläche | [nix.systemausfall.org](https://nix.systemausfall.org ) |
| Registrierung | [nix.systemausfall.org/accounts/new](https://nix.systemausfall.org/accounts/new) |
| Onion Service | [go7ryu2mm5u5jdwrwacom5hpw3nn55hfxnwggyfcnvnicvwvsxqdjeid.onion](http://go7ryu2mm5u5jdwrwacom5hpw3nn55hfxnwggyfcnvnicvwvsxqdjeid.onion) |
## Passwort zurücksetzen
Aktuell bietet die Verwaltungsoberfläche keine Möglichkeit, dein Passwort zurück zu setzen. Deshalb solltest du selbst dafür sorgen, dass dein [Passwort](/konto/passworte) nicht verloren geht. Die einzige Möglichkeit, wieder Zugriff auf die Verwaltungsoberfläche zu erlangen, besteht im Löschen und Neuanlegen deines Kontos. Nimm' in diesem Fall bitte [Kontakt](https://systemausfall.org/contact) mit uns auf.

View file

@ -0,0 +1,18 @@
---
title: "Unverschlüsselte Listen"
date: 2022-11-06T16:54:00+01:00
geekdocCollapseSection: true
---
Für unverschlüsselte Mailinglisten nutzen wir den Listenmanager [Sympa](https://sympa.community). Alle Listen laufen unter der Domain `@wat.systemausfall.org`.
## Eigenschaften
| Option | Beschreibung |
|--------|--------------|
| Maximal Anzahl der Adressen | unbegrenzt |
| Größe des Archivs | 100 MB |
| Maximale Größe eines Anhangs | 10 MB |
| Speicherplatz für gemeinsame Dokumente | 10 MB |
Der Speicherplatz kann bei begründeten Bedarf auch erhöht werden.

View file

@ -0,0 +1,30 @@
---
title: "Abonnements"
date: 2022-11-08T21:23:13+01:00
resources:
- name: abo-1
src: "sympa_empfang.png"
title: "E-Mail-Empfang deaktivieren"
---
Es gibt verschiedene Möglichkeiten, E-Mail-Adressen zu einer Liste hinzuzufügen oder zu entfernen. Am einfachsten ist es über die [Verwaltungsoberfläche](/mailinglisten/sympa/verwaltung).
## Hinzufügen und Entfernen von Adressen per E-Mail
Um dich bei einer Liste anzumelden, kannst du eine E-Mail an diese Adresse schicken:
```Plain
LISTENNAME-subscribe@wat.systemausfall.org
```
*LISTENNAME* musst du natürlich durch den Namen deiner Liste ersetzen. Du wirst anschließend eine Bestätigungsmail mit weiteren Anweisungen erhalten.
Das Abbestellen einer Liste per E-Mail muss durch den Listen-Admin in der Verwaltungoberfläche aktiviert werden. Ist das erfolgt, sende eine E-Mail an:
```Plain
LISTENNAME-unsubscribe@wat.systemausfall.org
```
## Stille Abos
Du kannst eine E-Mail-Adresse zum Einsenden an die Mailingliste berechtigen, ohne dass die Listennachrichten selbst an diese E-Mail-Adresse zugestellt werden. Dies kann z.B. dann sinnvoll sein, wenn du externen Personen (oder einem Newsletter) die Möglichkeit geben willst, an alle Listenmitglieder zu senden.
Füge dazu die Absenderadresse als Abonnentin zur Liste hinzu. Suche anschließend diese Adresse aus der Liste der Abonnentinnen heraus und klicke sie an. Du kannst nun unter *Empfang:* die Einstellung *Keine Mails* auswählen:
{{< img name="abo-1" size="small" >}}

Binary file not shown.

After

Width:  |  Height:  |  Size: 173 KiB

View file

@ -0,0 +1,28 @@
---
title: "Antwortadresse"
date: 2022-11-08T21:49:12+01:00
resources:
- name: adresse-1
src: "sympa_antwortadresse01.png"
title: Listenhautpseite
- name: adresse-2
src: "sympa_antwortadresse02.png"
title: Festlegen der Antwortadresse
---
Du kannst für deine Mailingliste festlegen, an wen die Antwort auf eine Listennachricht gehen soll. Die Einstellungen kannst du in der [Verwaltungsoberfläche](/mailinglisten/sympa/verwaltung) auf der Listenhauptseite unter *Listenkonfiguration* --> *Ändern, wer in die Liste posten kann* vornehmen:
{{< img name="adresse-1" size="small" >}}
Dort findest du die Einstellungen zur *Antwortadresse (reply_to_header)*:
{{< img name="adresse-2" size="small" >}}
Folgende Möglichkeiten stehen dir zur Verfügung:
| Option | Beschreibung |
|--------|--------------|
| Absender (sender) | Antworten gehen nur an die Absender:in |
| Liste (list) | Antworten gehen an die Listenadresse |
| alle (all) | Antworten gehen an die Listenadresse und zusätzlich an die Absender:in |
| andere E-Mail-Adresse (other_email) | Antworten gehen an eine von dir festgelegte E-Mail-Adresse |

Binary file not shown.

After

Width:  |  Height:  |  Size: 193 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 134 KiB

View file

@ -0,0 +1,88 @@
---
title: "Eigene Domain"
date: 2022-11-07T16:41:58+01:00
---
Du kannst deine eigene Maildomain mit unserem Sympa-Mailinglistenserver verknüpfen. Dazu musst du im Wesentlichen bei deinem Domainanbieter einige DNS-Einträge anlegen. Den Rest erledigen wir. Auf dieser Seite findest du dazu alle notwendigen Angaben. Die Erläuterungen erfolgen am Beispiel der Maildomain `example.org`.
{{< hint title="Hinweis" >}}
Sofern du deine Domain bereits für E-Mail-Konten benutzt, benötigst du für die Mailinglisten eine neue Subdomain. Es ist nicht möglich, dass du für die E-Mail-Konten und Mailinglisten die selbe Domain verwendest. Oft verwendete Subdomains für Mailinglisten sind `lists.example.org`, `listen.example.org` oder auch `ml.example.org`.
{{< /hint >}}
{{< toc >}}
## Nutzungsvereinbarungen
{{< include file="/static/_includes/tos.md.part" >}}
## Kostenbeteiligung
{{< include file="/static/_includes/spendenhinweis.md.part" >}}
{{< rawhtml >}}
{{< include file="/static/_includes/twingle.md.part" >}}
{{< /rawhtml >}}
## Domainregistrierung
{{< include file="/static/_includes/domainanbieter.md.part" >}}
## DNS-Einstellungen
Die DNS-Einstellungen kannst du in der Weboberfläche deines Domainanbieters vornehmen. Es ist möglich, dass die Bezeichnungen dort von den hier verwendeten leicht abweichen.
### A-Eintrag
Du kannst deine Mailinglisten bequem per Weboberfläche verwalten. Lege dazu einen so genannten A-Eintrag an:
- Record-Type: A
- Record-Name: example.org
- Inhalt/Ziel: 51.75.71.249
### MX-Eintrag
Für die Subdomain deiner Wahl musst du einen MX_Resource_Record anlegen. Dieser gibt an, welcher Mailserver für deine Maildomain zuständig ist.
Folgende MX-Einträge sind für deine Domain notwendig:
```Plain
NAME INHALT Priorität TTL
example.org mx1.systemausfall.org 20 86400
example.org mx2.systemausfall.org 80 86400
```
### SPF-Eintrag
{{< include file="/static/_includes/spf.md.part" >}}
### DKIM-Eintrag
{{< include file="/static/_includes/dkim.md.part" >}}
### DNS-Einstellungen überprüfen
Ob deine Einstellungen korrekt gespeichert wurden, kannst du mit dem Linux-Programm `dig` testen.
- Prüfen des MX-Eintrags:
```Shell
dig MX example.org
```
- Prüfen des SPF-Eintrags:
```Shell
dig TXT example.org
```
- Prüfen des DKIM-Eintrags:
```Shell
dig TXT mail._domainkey.example.org
```
Bei frisch angelegten DNS-Einträgen kann es eine Weile dauern, bis du eine Antwort auf deine Abfrage erhältst. Im Abfrage-Ergebnis sollten deine Einträg korrekt angezeigt werden, bspw:
```Plain
;; ANSWER SECTION:
example.org. 86400 IN MX 20 mx2.systemausfall.org.
```
## Abschließende Einrichtung
- Verwaltungsoberfläche: Du kannst deine Mailinglisten selbständig verwalten. Den Link zur Verwaltungsoberfläche senden wir dir per E-Mail zu.
- Listmaster festlegen: Als Listmaster wird eine Person bezeichnet, die in der Verwaltungsoberfläche die vollen Rechte hat. Bitte teile uns eine oder mehrere E-Mailadressen mit, die wir als Listmaster festlegen sollen.
- Berechtigungen zum Listenanlegen festlegen: Die Listensoftware erlaubt die Festelegung der Rechte zum Listenerstellen. Es gibt folgende Möglichkeiten:
- Listen dürfen beliebig angelegt werden
- Listen dürfen beliebig angelegt werden, müssen aber vom Listmaster aktiviert werden
- Listen dürfen nur von bestimmten Personen angelegt werden. Die Identifizierung kann anhand einzelner Mailadressen oder einer Maildomain erfolgen

View file

@ -0,0 +1,19 @@
---
title: "FAQ"
date: 2022-11-08T22:15:13+01:00
---
## Wie lässt sich ein ein Präfix zum Betreff jeder Listen-Mail hinzufügen?
Über die Listen-Hauptseite --> *Listenkonfiguration* --> *Listenkonfiguration bearbeiten* --> *Einstellungen zum Senden/Empfangen*. Dort kannst du nun unter *Titelmarkierung (custom_subject)* den Präfix eintragen.
## Wie kann ich das Archiv ein- oder ausschalten?
Du kannst das Archiv deiner Liste selbständig ein- oder auszuschaten. Die Einstellungen findet du unter *Administration* --> *Listenkonfiguration bearbeiten* --> *Archive*.
## Wie kann ich den Absender einer Listenmail verändern?
Du kannst als privelegierter Listenbesitzer deine Mailingliste so einrichten, dass eine beliebige Adresse als Absenderadresse erscheint. So ist von außen nicht ersichtlich, wer die Nachricht eingeschickt hat. Die Einstellung findest du auf der Listen-Hauptseite unter *Listenkonfiguration* --> *Ändern, wer in die Liste posten kann* --> *Anonymer Absender*. Durch das Setzen dieser Option werden folgende Kopfzeilen aus jeder Listennachricht entfernt:
```Plain
Received:, Reply-To:, Sender:, X-Sender:, Message-id:, Resent-From:
```

View file

@ -0,0 +1,26 @@
---
title: "Kopf- und Fußzeilen"
date: 2022-11-06T17:10:15+01:00
resources:
- name: kopfzeile-1
src: "sympa_vorlagen01.png"
title: Fußzeile erstellen
---
Jede Nachricht kann mit einer festegelten Kopf- und Fußzeile versehen werden. Bspw. enthalten viele Listen Hinweise auf das selbständige Abbestellen einer Liste in der Fußzeile. Die Einstellungen kannst du unter *Administration* --> dann im Menü *Listenkonfiguration bearbeiten* --> *Nachrichtenvorlagen* vornehmen.
{{< img name="kopfzeile-1" size="small" >}}
## Fußzeile mit Abbestellen-Link
Du kannst die Fußzeile so gestalten, dass sie einen Link zur Abbestellung der Liste enthält:
- Aktiviere die Nachrichtenpersonalisierung. Durch die Aktivierung der Personalisierung behandelt der Mailinglisten-Manager die Textbereich eingehender Nachrichten als Template. Dadurch können Variablen genutzt werden, die dann automatisch ersetzt werden. Die Aktivierung erfolgt über: *Listen-Hauptseite* --> *Listenkonfiguration* --> *Ändern, wer in die Liste posten kann* --> *Nachrichtenpersonalisierung zulassen*".
- Erstelle eine Fußzeile (siehe oben).
- Füge folgenden Text ein:
```Plain
Zum Abbestellung dieser Liste hier klicken:
[% wwsympa_url %][% 'auto_signoff' | url_abs([listname],{email=>user.email}) %]
```
- Während du die erste Zeile anpassen kannst, muss die zweite Zeile unverändert bleiben.
Weitere Informationen zur Nachrichtenpersonalisierung und den möglichen Template-Variablen findest du [hier](https://www.sympa.community/manual/customize/message-personalization.html).

Binary file not shown.

After

Width:  |  Height:  |  Size: 196 KiB

View file

@ -0,0 +1,18 @@
---
title: "Neue Admins hinzufügen"
date: 2022-11-06T16:59:28+01:00
resources:
- name: admin-1
src: "sympa_admin01.png"
title: Neue Besitzerin zur Liste hinzufügen
---
Die Mailingliste unterscheidet verschiedene Rollen:
- Abonnenten: Können E-Mails an der Liste schicken und/oder von ihr empfangen.
- Moderatoren (editor): Sofern die Liste so konfiguriert ist, begutachten sie eingesandte Nachrichten, bevor sie an die Liste weitergeleitet werden-
- Besitzer (owner): Auch Eigentümer genannt. Kann alle Einstellungen an der Liste vornehmen.
## Weitere Besitzer und Moderatoren hinzufügen
Du kannst beliebig viele Besitzer und Moderatoren zu deiner Liste hinzufügen. Klicke dazu rechts im Menü auf *Administration*. Anschließend findest du in der roten Menüleiste unter *Benutzer* die entsprechenden Funtkionen:
{{< img name="admin-1" size="small" >}}

Binary file not shown.

After

Width:  |  Height:  |  Size: 205 KiB

View file

@ -0,0 +1,17 @@
---
title: "Neue Liste anlegen"
date: 2022-11-06T16:55:20+01:00
---
Neue Listen können über die [Verwaltungsoberfläche](https://wat.systemausfall.org) angelegt werden. Nach der Anmeldung findest du oben rechts oben im Menü den Punkt *Liste beantragen* über den du zum entsprechenden Formular gelangst. Wichtig ist, dass du alle Felder ausfüllst:
| Option | Bedeutung |
|--------|-----------|
| Listenname | Ein beliebiger Name für deine Liste. Der Listenname ist Teil der Listenadresse nach dem Muster: `LISTENNAME@wat.systemausfall.org`. Trage hier nur den Listennamen ein (ohne @wat.systemausfall.org). |
| Listentyp | Entsprechend deiner Auswahl wird die Liste eingerichtet, damit du nicht alle Einstellungen manuell vornehmen musst. Du kannst deine Liste anschließend individuell anpassen. |
| Titel | Eine Beschreibung, die unter deiner Listen in der Listenübersicht angezeigt wird. |
| Zielgruppe | Damit lassen sich Listen nach Themen gruppieren - das ist für dich praktisch, wenn du viele Listen verwaltest. |
| Beschreibung | Trage eine aussagekräftige Beschreibung der Liste, damit für uns ersichtlich ist, dass die Liste unseren Nutzungsvereinbarungen entspricht. |
{{< hint title="Hinweis" >}}
Sofern du dich mit deinem systemausfall.org-Konto angemeldet hast, ist deine neue Liste sofort aktiv. Alle anderen Listen werden wir nach Prüfung aktivieren.
{{< /hint >}}

View file

@ -0,0 +1,11 @@
---
title: "Verwaltung"
date: 2022-11-06T16:55:26+01:00
---
Die Verwaltung deiner Liste geht am einfachsten über unsere [Weboberfläche](https://wat.systemausfall.org). Mit deinem systemausfall.org-Konto kannst du dich dort automatisch anmelden. Listen-Verwalter:innen ohne systemausfall.org-Konto können sich selbständig ein Verwaltungskonto [einrichten](https://wat.systemausfall.org/firstpasswd).
| Option | Beschreibung |
|--------|--------------|
| Verwaltungsoberfläche | [wat.systemausfall.org](https://wat.systemausfall.org ) |
| Registrierung | [wat.systemausfall.org/firstpasswd](https://wat.systemausfall.org/firstpasswd) |