mirror of
https://github.com/friendica/friendica
synced 2024-11-14 06:22:54 +00:00
f2e1bcfc7d
- Remove reference to PHP < 7.1
425 lines
24 KiB
Markdown
425 lines
24 KiB
Markdown
# Settings
|
|
|
|
* [Zur Startseite der Hilfe](help)
|
|
|
|
Wenn du der Administrator einer Friendica-Instanz bist, hast du Zugriff auf das so genannte **Admin Panel** in dem du die Friendica-Instanz konfigurieren kannst,
|
|
|
|
Auf der Startseite des Admin Panels werden die Informationen zu der Instanz zusammengefasst.
|
|
Die erste Zahl gibt die Anzahl von Nachrichten an, die nicht zugestellt werden konnten.
|
|
Die Zustellung wird zu einem späteren Zeitpunkt noch einmal versucht.
|
|
Unter dem Punkt "Warteschlange Inspizieren" kannst du einen schnellen Blick auf die zweite Warteschlange werfen.
|
|
Die zweite Zahl steht für die Anzahl der Aufgaben, die die Worker noch vor sich haben.
|
|
Die Worker arbeiten Hintergrundprozesse ab.
|
|
Die Aufgaben der Worker sind priorisiert und werden anhand dieser Prioritäten abgearbeitet.
|
|
|
|
Des weiteren findest du eine Übersicht über die Accounts auf dem Friendica Knoten, die unter dem Punkt "Nutzer" moderiert werden können.
|
|
Sowie eine Liste der derzeit aktivierten Addons.
|
|
Diese Liste ist verlinkt, so dass du schnellen Zugriff auf die Informationsseiten der einzelnen Addons hast.
|
|
Abschließend findest du auf der Startseite des Admin Panels die installierte Version von Friendica.
|
|
Wenn du in Kontakt mit den Entwicklern trittst und Probleme oder Fehler zu schildern, gib diese Version bitte immer mit an.
|
|
|
|
Die Unterabschnitte des Admin Panels kannst du in der Seitenleiste auswählen.
|
|
|
|
## Seite
|
|
|
|
In diesem Bereich des Admin Panels findest du die Hauptkonfiguration deiner Friendica-Instanz.
|
|
Er ist in mehrere Unterabschnitte aufgeteilt, wobei die Grundeinstellungen oben auf der Seite zu finden sind.
|
|
|
|
Da die meisten Konfigurationsoptionen einen Hilfstext im Admin Panel haben, kann und will dieser Artikel nicht alle Einstellungen abdecken.
|
|
|
|
### Grundeinstellungen
|
|
|
|
#### Banner/Logo
|
|
|
|
Hiermit legst du das Banner der Seite fest. Standardmäßig ist das Friendica-Logo und der Name festgelegt.
|
|
Du kannst hierfür HTML/CSS nutzen, um den Inhalt zu gestalten und/oder die Position zu ändern, wenn es nicht bereits voreingestellt ist.
|
|
|
|
#### Systensprache
|
|
|
|
Diese Einstellung legt die Standardsprache der Instanz fest.
|
|
Sie wird verwendet, wenn es Friendica nicht gelingt die Spracheinstellungen des Besuchers zu erkennen oder diese nicht unterstützt wird.
|
|
Nutzer können diese Auswahl in den Einstellungen des Benutzerkontos überschreiben.
|
|
|
|
Die Friendica Gemeinschaft bietet einige Übersetzungen an, von denen einige mehr andere weniger komplett sind.
|
|
Mehr Informationen zum Übersetzungsprozess von Friendica findest du [auf dieser Seite](/help/translations) der Dokumentation.
|
|
|
|
#### Systemweites Theme
|
|
|
|
Hier kann das Theme bestimmt werden, welches standardmäßig zum Anzeigen der Seite verwendet werden soll.
|
|
Nutzer können in ihren Einstellungen andere Themes wählen.
|
|
Derzeit ist das "vier" Theme das vorausgewählte Theme.
|
|
|
|
Für mobile Geräte kannst du ein spezielles Theme wählen, wenn das Standardtheme ungeeignet für mobile Geräte sein sollte.
|
|
Das `vier` Theme z.B. unterstützt kleine Anzeigen und benötigt kein zusätzliches mobiles Theme.
|
|
|
|
### Registrierung
|
|
|
|
#### Registrierungsmethode
|
|
|
|
Diese Einstellung regelt die Art der Registrierung.
|
|
Dabei kannst du zwischen den folgenden Optionen wählen:
|
|
|
|
* **Offen**: Jeder kann ein neues Nutzerkonto anlegen und es sofort benutzen.
|
|
* **Bedarf der Zustimmung**: Jeder kann ein Nutzerkonto anlegen. Dieses muss allerdings durch den Admin freigeschaltet werden, bevor es verwendet werden kann.
|
|
* **Geschlossen**: Es können keine weiteren Nutzerkonten angelegt werden.
|
|
|
|
##### Einladungen
|
|
|
|
Zusätzlich zu den oben genannten Möglichkeiten, kann die Registrierung eines neuen Nutzerkontos an eine Einladung durch einen bestehenden Nutzer gekoppelt werden.
|
|
Hierzu muss in der [config/local.config.php](/help/Config) Datei die Option `invitation_only` aktiviert und als Registrierungsmethode entweder *Offen* oder *Bedarf der Zustimmung* gewählt werden.
|
|
|
|
#### Namen auf Vollständigkeit überprüfen
|
|
|
|
Es kann vorkommen, dass viele Spammer versuchen, sich auf deiner Seite zu registrieren.
|
|
In Testphasen haben wir festgestellt, dass diese automatischen Registrierungen das Feld "Vollständiger Name" oft nur mit Namen ausfüllen, die kein Leerzeichen beinhalten.
|
|
Wenn du Leuten erlauben willst, sich nur mit einem Namen anzumelden, dann setze die Einstellung auf "true".
|
|
Die Standardeinstellung ist auf "false" gesetzt.
|
|
|
|
#### OpenID Unterstützung
|
|
|
|
Standardmäßig wird OpenID für die Registrierung und für Logins genutzt.
|
|
Wenn du nicht willst, dass OpenID-Strukturen für dein System übernommen werden, dann setze "no_openid" auf "true".
|
|
Standardmäßig ist hier "false" gesetzt.
|
|
|
|
#### Unterbinde Mehrfachregistrierung
|
|
|
|
Um mehrfache Seiten zu erstellen, muss sich eine Person mehrfach registrieren können.
|
|
Deine Seiteneinstellung kann Registrierungen komplett blockieren oder an Bedingungen knüpfen.
|
|
Standardmäßig können eingeloggte Nutzer weitere Accounts für die Seitenerstellung registrieren.
|
|
Hier ist weiterhin eine Bestätigung notwendig, wenn "REGISTER_APPROVE" ausgewählt ist.
|
|
Wenn du die Erstellung weiterer Accounts blockieren willst, dann setze die Einstellung "block_extended_register" auf "true".
|
|
Standardmäßig ist hier "false" gesetzt.
|
|
|
|
### Datei hochladen
|
|
|
|
#### Datenspeicher Backend
|
|
|
|
Legt das Datenspeicher Backend fest, mit dem Friendica hoch geladene Daten speichert.
|
|
Zwei Speicher Backends sind standardmäßig bei Friendica verfügbar:
|
|
|
|
- **Database** : Die Daten werden in einer speziellen Tabelle in der Datenbank (`storage`) gespeichert.
|
|
- **Filesystem** : Die Daten werden als Dateien im Dateisystem gespeichert.
|
|
|
|
Weitere Speicher Backends können als Addons von Drittanbietern verfügbar sein.
|
|
Falls ein solches verwendet wird, sei an dieser Stelle nur auf deren Dokumentation für weitere Informationen verwiesen.
|
|
|
|
Die Grundeinstellung ist 'Datenbank (legacy)': Dies ist die alte Methode von Friendica Daten direkt in der Datenbank abzulegen.
|
|
|
|
Bestehende Daten können zum aktuell ausgewählten Backend verschoben werden.
|
|
Hierfür kann der ['storage move'](help/tools) Befehl der Friendica Konsole verwendet werden.
|
|
|
|
Sollte das ausgewählte Speicher Backand zusätzliche Konfigurationsparameter besitzen, werden nach der Auswahl des Backends hier weitere Felder angezeigt.
|
|
|
|
##### Dateipfad zum Speicher
|
|
|
|
Der Basispfad unter dem das Filesystem Datenspeicher Backend die Daten speichern soll.
|
|
|
|
Um zu verhindern, dass Daten unter Umgehung der Privatsphären-Einstellungen herunter geladen werden, sollte dieser Pfad außerhalb der Verzeichnisstruktur des Webservers liegen.
|
|
|
|
Die Grundeinstellung ist `storage`, das ist das `storage` Unterverzeichnis innerhalb des Friendica Verzeichnisses.
|
|
|
|
#### Maximale Bildgröße
|
|
|
|
Maximale Bild-Dateigröße in Byte. Standardmäßig ist 0 gesetzt, was bedeutet, dass kein Limit gesetzt ist.
|
|
|
|
### Regeln
|
|
|
|
#### URL des weltweiten Verzeichnisses
|
|
|
|
Mit diesem Befehl wird die URL eingestellt, die zum Update des globalen Verzeichnisses genutzt wird.
|
|
Dieser Befehl ist in der Standardkonfiguration enthalten.
|
|
Der nicht dokumentierte Teil dieser Einstellung ist, dass das globale Verzeichnis gar nicht verfügbar ist, wenn diese Einstellung nicht gesetzt wird.
|
|
Dies erlaubt eine private Kommunikation, die komplett vom globalen Verzeichnis isoliert ist.
|
|
|
|
#### Erzwinge Veröffentlichung
|
|
|
|
Standardmäßig können Nutzer selbst auswählen, ob ihr Profil im Seitenverzeichnis erscheint.
|
|
Diese Einstellung zwingt alle Nutzer dazu, im Verzeichnis zu erscheinen.
|
|
Diese Einstellung kann vom Nutzer nicht deaktiviert werden. Die Standardeinstellung steht auf "false".
|
|
|
|
#### Öffentlichen Zugriff blockieren
|
|
|
|
Aktiviere diese Einstellung um den öffentlichen Zugriff auf alle Seiten zu sperren, solange man nicht eingeloggt ist.
|
|
Das blockiert die Ansicht von Profilen, Freunden, Fotos, vom Verzeichnis und den Suchseiten.
|
|
Ein Nebeneffekt ist, dass Einträge dieser Seite nicht im globalen Verzeichnis erscheinen.
|
|
Wir empfehlen, speziell diese Einstellung auszuschalten (die Einstellung ist an anderer Stelle auf dieser Seite erklärt).
|
|
Beachte: das ist speziell für Seiten, die beabsichtigen, von anderen Friendica-Netzwerken abgeschottet zu sein.
|
|
Unautorisierte Personen haben ebenfalls nicht die Möglichkeit, Freundschaftsanfragen von Seitennutzern zu beantworten.
|
|
Die Standardeinstellung ist deaktiviert.
|
|
Verfügbar in Version 2.2 und höher.
|
|
|
|
#### Für Besucher verfügbare Gemeinschaftsseiten
|
|
|
|
Die Gemeinschaftsseiten zeigen all öffentlichen Beiträge.
|
|
Es gibt zwei Gemeinschaftsseiten, eine lokale auf der die Beiträge der Nutzer des Knotens gesammelt werden und eine globale auf der alle bekannten Beiträge aus dem gesamten Netzwerk erscheinen.
|
|
Mit dieser Einstellung kann geregelt werden, welche dieser beiden Seiten Besucher aufrufen können.
|
|
Angemeldete Nutzer des Knotens können grundsätzlich beide Seiten verwenden.
|
|
|
|
**Hinweis**: Einige Einstellungen, wie z.B. das Verbergen von Kontakten auf der Profilseite, können die Sichtbarkeit der Beiträge auf der Gemeinschaftsseiten beeinflussen.
|
|
|
|
#### Erlaubte Domains für Kontakte
|
|
|
|
Kommagetrennte Liste von Domains, welche eine Freundschaft mit dieser Seite eingehen dürfen.
|
|
Wildcards werden akzeptiert Standardmäßig sind alle gültigen Domains erlaubt.
|
|
|
|
Mit dieser Option kann man einfach geschlossene Netzwerke, z.B. im schulischen Bereich aufbauen, aus denen nicht mit dem Rest des Netzwerks kommuniziert werden soll.
|
|
|
|
#### Erlaubte Domains für E-Mails
|
|
|
|
Kommagetrennte Liste von Domains, welche bei der Registrierung als Part der Email-Adresse erlaubt sind.
|
|
Das grenzt Leute aus, die nicht Teil der Gruppe oder Organisation sind.
|
|
Wildcards werden akzeptiert Standardmäßig sind alle gültigen Email-Adressen erlaubt.
|
|
|
|
#### Nutzern erlauben das remote_self Flag zu setzen
|
|
|
|
Webb du die Option `Nutzern erlauben das remote_self Flag zu setzen` aktivierst, können alle Nutzer Atom Feeds in den erweiterten Einstellungen des Kontakts als "Entferntes Konto" markieren.
|
|
Dadurch werden automatisch alle Beiträge dieser Feeds für diesen Nutzer gespiegelt und an die Kontakte bei Friendica verteilt.
|
|
|
|
Dieses Feature kann z.B. dafür genutzt werden Blogbeiträge zu spiegeln.
|
|
In der Grundeinstellung ist es nicht aktiviert, da es zusätzliche Last auf dem Server verursachen kann.
|
|
Außerdem könnte es durch Nutzer als Spam Verteiler missbraucht werden.
|
|
|
|
Als Administrator der Friendica-Instanz kannst du diese Einstellungen ansonsten nur direkt in der Datenbank vornehmen.
|
|
Bevor du das tust solltest du sicherstellen, dass du ein Backup der Datenbank hast und genau weißt was die Änderungen an der Datenbank bewirken, die du vornehmen willst.
|
|
|
|
#### Explizite Inhalte
|
|
|
|
Wenn Sie einen Knoten mit explizitem, nicht jugendfreien Inhalt betreiben, können Sie dies mit dieser Option ankündigen.
|
|
Ist diese Option aktiviert, wird ein Informationsflag in den veröffentlichten Informationen zu Ihrem Knoten gesetzt.
|
|
(Sollte *Server Informationen veröffentlichen* aktiviert sein.)
|
|
|
|
Zusätzlich wird auf der Registrierungsseite für neue Benutzer ein Hinweis angezeigt.
|
|
|
|
### Erweitert
|
|
|
|
#### Proxy Einstellungen
|
|
|
|
Wenn deine Seite eine Proxy-Einstellung nutzt, musst du diese Einstellungen vornehmen, um mit anderen Seiten im Internet zu kommunizieren.
|
|
|
|
#### Netzwerk Wartezeit
|
|
|
|
Legt fest, wie lange das Netzwerk warten soll, bevor ein Timeout eintritt.
|
|
Der Wert wird in Sekunden angegeben. Standardmäßig ist 60 eingestellt; 0 steht für "unbegrenzt" (nicht empfohlen).
|
|
|
|
#### UTF-8 Reguläre Ausdrücke
|
|
|
|
Während der Registrierung werden die Namen daraufhin geprüft, ob sie reguläre UTF-8-Ausdrücke nutzen.
|
|
Hierfür wird PHP benötigt, um mit einer speziellen Einstellung kompiliert zu werden, die UTF-8-Ausdrücke benutzt.
|
|
Wenn du absolut keine Möglichkeit hast, Accounts zu registrieren, setze diesen Wert auf ja.
|
|
|
|
#### SSL Überprüfen
|
|
|
|
Standardmäßig erlaubt Friendica SSL-Kommunikation von Seiten, die "selbst unterzeichnete" SSL-Zertifikate nutzen.
|
|
Um eine weitreichende Kompatibilität mit anderen Netzwerken und Browsern zu gewährleisten, empfehlen wir, selbst unterzeichnete Zertifikate **nicht** zu nutzen.
|
|
Aber wir halten dich nicht davon ab, solche zu nutzen. SSL verschlüsselt alle Daten zwischen den Webseiten (und für deinen Browser), was dir eine komplett verschlüsselte Kommunikation erlaubt.
|
|
Auch schützt es deine Login-Daten vor Datendiebstahl. Selbst unterzeichnete Zertifikate können kostenlos erstellt werden.
|
|
Diese Zertifikate können allerdings Opfer eines sogenannten ["man-in-the-middle"-Angriffs](http://de.wikipedia.org/wiki/Man-in-the-middle-Angriff) werden, und sind daher weniger bevorzugt.
|
|
Wenn du es wünscht, kannst du eine strikte Zertifikatabfrage einstellen.
|
|
Das führt dazu, dass du keinerlei Verbindung zu einer selbst unterzeichneten SSL-Seite erstellen kannst
|
|
|
|
### Automatisch ein Kontaktverzeichnis erstellen
|
|
|
|
### Performance
|
|
|
|
### Worker
|
|
|
|
In diesem Abschnitt kann der Hintergrund-Prozess konfiguriert werden.
|
|
Bevor ein neuer *Worker* Prozess gestartet wird, überprüft das System, dass die vorhandenen Resourchen ausrechend sind,
|
|
Aus diesem Grund kann es sein, dass die maximale Zahl der Hintergrungprozesse nicht erreicht wird.
|
|
|
|
Sollte die PHP Funktion `proc_open` auf dem Server nicht verfügbar sein, kann die Verwendung durch Friendica hier unterbunden werden.
|
|
|
|
Die Aufgaben die im Hintergrund erledigt werden, haben Prioritäten zugeteilt.
|
|
Um garantieren zu können, das wichtige Prozesse schnellst möglich abgearbeitet werden können, selbst wenn das System gerade stark belastet ist, sollte die *fastlane* aktiviert sein.
|
|
|
|
Wenn es auf deinem Server nicht möglich ist, einen cron Job zu starten, kannst du den *frontend* Worker einschalten.
|
|
Nachdem dies geschehen ist, kannst du `example.com/worker` (tausche example.com mit dem echten Domainnamen aus) aufrufen werden.
|
|
Dadurch werden dann die Aufgaben aktiviert, die der cron Job sonst aktivieren würde.
|
|
|
|
### Umsiedeln
|
|
|
|
## Nutzer
|
|
|
|
In diesem Abschnitt des Admin Panels kannst du die Nutzer deiner Friendica-Instanz moderieren.
|
|
|
|
Solltest du für **Registrierungsmethode** die Einstellung "Bedarf Zustimmung" gewählt haben, werden hier zu Beginn der Seite neue Registrationen aufgelistet.
|
|
Als Administrator kannst du hier die Registration akzeptieren oder ablehnen.
|
|
|
|
Unter dem Abschnitt mit den Registrationen werden die aktuell auf der Instanz registrierten Nutzer aufgelistet.
|
|
Die Liste kann nach Namen, E-Mail Adresse, Datum der Registration, der letzten Anmeldung oder dem letzten Beitrag und dem Account Typ sortiert werden.
|
|
An dieser Stelle kannst du existierende Accounts vom Zugriff auf die Instanz blockieren, sie wieder frei geben oder Accounts endgültig löschen.
|
|
|
|
Im letzten Bereich auf der Seite kannst du als Administrator neue Accounts anlegen.
|
|
Das Passwort für so eingerichtete Accounts werden per E-Mail an die Nutzer geschickt.
|
|
|
|
## Addons
|
|
|
|
Dieser Bereich des Admin Panels dient der Auswahl und Konfiguration der Erweiterungen von Friendica.
|
|
Sie müssen in das `/addon` Verzeichnis kopiert werden.
|
|
Auf der Seite wird eine Liste der verfügbaren Erweiterungen angezeigt.
|
|
Neben den Namen der Erweiterungen wird ein Indikator angezeigt, der anzeigt ob das Addon gerade aktiviert ist oder nicht.
|
|
|
|
Wenn du die Erweiterungen aktualisiert die du auf deiner Friendica-Instanz nutzt könnte es sein, dass sie neu geladen werden müssen, damit die Änderungen aktiviert werden.
|
|
Um diesen Prozess zu vereinfachen gibt es am Anfang der Seite einen Button um alle aktiven Addons neu zu laden.
|
|
|
|
## Themen
|
|
|
|
Der Bereich zur Kontrolle der auf der Friendica-Instanz verfügbaren Themen funktioniert analog zum Addons Bereich.
|
|
Jedes Theme hat eine extra Seite auf der der aktuelle Status, ein Bildschirmfoto des Themes, zusätzliche Informationen und eventuelle Einstellungen des Themes zu finden sind.
|
|
Genau wie Erweiterungen können Themes in der Übersichtsliste oder der Theme-Seite aktiviert bzw. deaktiviert werden.
|
|
Um ein Standardtheme für die Instanz zu wählen, benutze bitte die *Seiten* Bereich des Admin Panels.
|
|
|
|
## Zusätzliche Features
|
|
|
|
Es gibt einige optionale Features in Friendica, die Nutzer benutzen können oder halt nicht.
|
|
Zum Beispiel den *dislike* Button oder den *Webeditor* beim Erstellen von neuen Beiträgen.
|
|
In diesem Bereich des Admin Panels kannst du die Grundeinstellungen für diese Features festlegen und gegebenenfalls die Entscheidung treffen, dass Nutzer deiner Instanz diese auch nicht mehr ändern können.
|
|
|
|
## DB Updates
|
|
|
|
Wenn sich die Datenbankstruktur Friendicas ändert werden die Änderungen automatisch angewandt.
|
|
Solltest du den Verdacht haben, das eine Aktualisierung fehlgeschlagen ist, kannst du in diesem Bereich des Admin Panels den Status der Aktualisierungen überprüfen.
|
|
|
|
## Warteschlange Inspizieren
|
|
|
|
Auf der Eingangsseite des Admin Panels werden zwei Zahlen fpr die Warteschlangen angegeben.
|
|
Die zweite Zahl steht für die Beiträge, die initial nicht zugestellt werden konnten und später nochmal zugestellt werden sollen.
|
|
Sollte diese Zahl durch die Decke brechen, solltest du nachsehen an welchen Kontakt die Zustellung der Beiträge nicht funktioniert.
|
|
|
|
Unter dem Menüpunkt "Warteschlange Inspizieren" findest du eine Liste dieser nicht zustellbaren Beiträge.
|
|
Diese Liste ist nach dem Empfänger sortiert.
|
|
Die Kommunikation zu dem Empfänger kann aus unterschiedlichen Gründen gestört sein.
|
|
Der andere Server könnte offline sein, oder gerade einfach nur eine hohe Systemlast aufweisen.
|
|
|
|
Aber keine Panik!
|
|
Friendica wird die Beiträge nicht für alle Zeiten in der Warteschlange behalten.
|
|
Nach einiger Zeit werden Knoten als inaktiv identifiziert und Nachrichten an Nutzer dieser Knoten aus der Warteschlange gelöscht.
|
|
|
|
## Server Blockliste
|
|
|
|
Auf dieser Seite des Admin Panels können Administratoren einer Friendica-Instanz die komplette Kommunikation (eingehend und ausgehend) mit bestimmten Domains unterbinden.
|
|
Für jede dieser Blockierungen muss ein Grund angegeben werden, welcher auf der Informationsseite [friendica](/friendica) angezeigt wird.
|
|
Der Abgleich der Domainnamen ist exakt, Subdomains werden nicht automatisch ebenfalls blockiert.
|
|
|
|
## Federation Statistik
|
|
|
|
Deine Instanz ist ein Teil eines Netzwerks von Servern dezentraler sozialer Netzwerke, der sogenannten **Federation**.
|
|
In diesem Bereich des Admin Panels findest du ein paar Zahlen zu dem Teil der Federation, die deine Instanz kennt.
|
|
|
|
## Eintrag löschen
|
|
|
|
Hier kann man als Admin einer Friendica Instanz Beiträge und ggf. damit gekoppelte Unterhaltungen von der Instanz löschen.
|
|
Dazu muss man nur die GUID des Beitrags kennen.
|
|
Diese kann u.a. in der Adresse der `/display`-Seite gefunden werden, wenn man dem *Link zum Originalbeitrag* folgt.
|
|
Hier ist die GUID der letzte Teil der URL in der Adresszeile des Browsers.
|
|
|
|
## Addon Features
|
|
|
|
Einige der Erweiterungen von Friendica benötigen global gültige Einstellungen, die der Administrator vornehmen muss.
|
|
Diese Erweiterungen sind hier aufgelistet, damit du die Einstellungen schneller findest.
|
|
|
|
## Protokolle
|
|
|
|
Dieser Bereich des Admin Panels ist auf zwei Seiten verteilt.
|
|
Die eine Seite dient der Konfiguration, die andere dem Anzeigen der Logs.
|
|
|
|
Du solltest die Logdatei nicht in einem Verzeichnis anlegen, auf das man vom Internet aus zugreifen kann.
|
|
Wenn du das dennoch tun musste und die Standardeinstellungen des Apache Servers verwendest, dann solltest du darauf achten, dass die Logdateien mit der Endung `.log` oder `.out` enden.
|
|
Solltest du einen anderen Webserver verwenden, solltest du sicherstellen, dass der Zugrif zu Dateien mit diesen Endungen nicht möglich ist.
|
|
|
|
Es gibt fünf Level der Ausführlichkeit mit denen Friendica arbeitet: Normal, Trace, Debug, Data und All.
|
|
Normalerweise solltest du für den Betrieb deiner Friendica-Instanz keine Logs benötigen.
|
|
Wenn du versuchst einem Problem auf den Grund zu gehen, solltest du das "DEBUG" Level wählen.
|
|
Mit dem "All" Level schreibt Friendica alles in die Logdatei.
|
|
Die Datenmenge der geloggten Daten kann relativ schnell anwachsen, deshalb empfehlen wir das Anlegen von Protokollen nur zu aktivieren wenn es unbedingt nötig ist.
|
|
|
|
**Die Größe der Logdateien kann schnell anwachsen**.
|
|
Du solltest deshalb einen Dienst zur [log rotation](https://en.wikipedia.org/wiki/Log_rotation) einrichten.
|
|
|
|
**Bekannte Probleme**: Der Dateiname `friendica.log` kann bei speziellen Server Konfigurationen zu Problemen führen (siehe [issue 2209](https://github.com/friendica/friendica/issues/2209)).
|
|
|
|
Normalerweise werden Fehler- und Warnmeldungen von PHP unterdrückt.
|
|
Wenn du sie aktivieren willst, musst du folgendes in der `config/local.config.php` Datei eintragen um die Meldungen in die Datei `php.out` zu speichern
|
|
|
|
error_reporting(E_ERROR | E_WARNING | E_PARSE );
|
|
ini_set('error_log','php.out');
|
|
ini_set('log_errors','1');
|
|
ini_set('display_errors', '0');
|
|
|
|
Die Datei `php.out` muss vom Webserver schreibbar sein und sollte ebenfalls außerhalb der Webverzeichnisse liegen.
|
|
Es kommt gelegentlich vor, dass nicht deklarierte Variablen referenziert werden, dehalb raten wir davon ab `E_NOTICE` oder `E_ALL` zu verwenden.
|
|
Die überwiegende Mehrzahl der auf diesen Stufen dokumentierten Fehler sind absolut harmlos.
|
|
Solltest du mit den oben empfohlenen Einstellungen Fehler finden, teile sie bitte den Entwicklern mit.
|
|
Im Allgemeinen sind dies Fehler, die behoben werden sollten.
|
|
|
|
Solltest du eine leere (weiße) Seite vorfinden, während du Friendica nutzt, werfe bitte einen Blick in die PHP Logs.
|
|
Solche *White Screens* sind so gut wie immer ein Zeichen dafür, dass ein Fehler aufgetreten ist.
|
|
|
|
## Diagnose
|
|
|
|
In diesem Bereich des Admin Panels findest du zwei Werkzeuge mit der du untersuchen kannst, wie Friendica bestimmte Ressourcen einschätzt.
|
|
Diese Werkzeuge sind insbesondere bei der Analyse von Kommunikationsproblemen hilfreich.
|
|
|
|
"Adresse untersuchen" zeigt Informationen zu einer URL an, wie Friendica sie wahrnimmt.
|
|
|
|
Mit dem zweiten Werkzeug "Webfinger überprüfen" kannst du Informationen zu einem Ding anfordern, das über einen Webfinger ( jemand@example.com ) identifiziert wird.
|
|
|
|
# Die Ausnahmen der Regel
|
|
|
|
Für die oben genannte Regel gibt es vier Ausnahmen, deren Konfiguration nicht über das Admin Panel vorgenommen werden kann.
|
|
Dies sind die Datenbank Einstellungen, die Administrator Accounts, der PHP Pfad und die Konfiguration einer eventuellen Installation in ein Unterverzeichnis unterhalb der Hauptdomain.
|
|
|
|
## Datenbank Einstellungen
|
|
|
|
Mit den folgenden Einstellungen kannst du die Zugriffsdaten für den Datenbank Server festlegen.
|
|
|
|
'database' => [
|
|
'hostname' => 'localhost',
|
|
'username' => 'mysqlusername',
|
|
'password' => 'mysqlpassword',
|
|
'database' => 'mysqldatabasename',
|
|
'charset' => 'utf8mb4',
|
|
],
|
|
|
|
Sollten alle der folgenden Environment-Variablen gesetzt sein, wird Friendica diese anstatt der vorher konfigurierten Werte nutzen.
|
|
|
|
MYSQL_HOST
|
|
MYSQL_PORT
|
|
MYSQL_USERNAME
|
|
MYSQL_PASSWORD
|
|
MYSQL_DATABASE
|
|
|
|
## Administratoren
|
|
|
|
Du kannst einen, oder mehrere Accounts, zu Administratoren machen.
|
|
Normalerweise trifft dies auf den ersten Account zu, der nach der Installation angelegt wird.
|
|
Die Liste der E-Mail Adressen kann aber einfach erweitert werden.
|
|
Mit keiner der angegebenen E-Mail Adressen können weitere Accounts registriert werden.
|
|
|
|
'config' => [
|
|
'admin_email' => 'you@example.com, buddy@example.com',
|
|
],
|
|
|
|
## PHP Pfad
|
|
|
|
Einige Prozesse von Friendica laufen im Hintergrund.
|
|
Für diese Prozesse muss der Pfad zu der PHP Version gesetzt sein, die verwendet werden soll.
|
|
|
|
'config' => [
|
|
'php_path' => '/usr/bin/php',
|
|
],
|
|
|
|
## Unterverzeichnis Konfiguration
|
|
|
|
Man kann Friendica in ein Unterverzeichnis des Webservers installieren.
|
|
Wir raten allerdings dringen davon ab, da es die Interoperabilität mit anderen Netzwerken (z.B. Diaspora, GNU Social, Hubzilla) verhindert.
|
|
Mal angenommen, du hast ein Unterverzeichnis tests und willst Friendica in ein weiteres Unterverzeichnis installieren, dann lautet die Konfiguration hierfür:
|
|
|
|
'system' => [
|
|
'urlpath' => 'tests/friendica',
|
|
],
|
|
|
|
## Weitere Ausnahmen
|
|
|
|
Es gibt noch einige experimentelle Einstellungen, die nur in der ``config/local.config.php`` Datei konfiguriert werden können.
|
|
Im [Konfigurationswerte, die nur in der config/local.config.php gesetzt werden können (EN)](help/Config) Artikel kannst du mehr darüber erfahren.
|