ssl_policy in der config/local.config.php auf 0 setzen nachdem der Installations-Assistent durchgelaufen ist. Aber mach das niemals für eine Friendica Instanz im Produktiven Einsatz!Wir haben versucht, dass Friendica auf den unterschiedlichsten Hosting-Plattformen installierbar ist. Gute Chance bestehen, wenn auf dem Server eine Wordpress oder Drupal Installation möglich ist. Um Friendica zu installieren, bieten wir einen manuellen und einen voll automatischen Weg an. Aber bedenke, dass Friendica mehr als eine einfache Webanwendung ist. Es handelt sich um ein komplexes Kommunikationssystem, das eher an einen Email-Server erinnert als an einen Webserver.
Um die Verfügbarkeit und Performance zu gewährleisten, werden Nachrichten im Hintergrund verschickt und gespeichert, um sie später zu verschicken, wenn eine Webseite gerade nicht erreichbar ist. Diese Funktionalität benötigt ein wenig mehr als die normalen Blogs. Nicht jeder PHP/MySQL-Hosting-Anbieter kann Friendica unterstützen. Viele hingegen können es. Aber bitte prüfe die Voraussetzungen deines Servers vor der Installation.
Wenn dir Fehler während der Installation auffallen, sag uns bitte über helper oder das Entwickler Forum Bescheid oder erstelle ein Issue.
Gib uns bitte so viele Infos zu deinem System, wie du kannst, und beschreibe den Fehler mit allen Details und Fehlermeldungen, so dass wir den Fehler zukünftig verhindern können. Aufgrund der großen Anzahl an verschiedenen Betriebssystemen und PHP-Plattformen haben wir nur geringe Kapazitäten, um deine PHP-Installation zu debuggen oder fehlende Module zu ersetzen, aber wir tun unser Bestes, um allgemeine Code-Fehler zu beheben.
Falls du noch keinen eigenen Friendica Account hast, kannst du dir einen temporäre Account auf einem der öffentlichen Server erstellen.Darüber kannst du den genannten Forum beitreten. Der Account wird nach 7 Tagen ablaufen, aber du kannst einen Server-Admin fragen, diesen Account länger zu erhalten, sollte das Problem nicht innerhalb dieser Zeit gelöst sein.
Solltest du keinen Zugriff auf die Kommandozeile auf deinem Server haben (z.B. via SSH) wirst du voraussichtlich Probleme bekommen die nötigen Server-Einstellungen einzurichten.
Für alternative Server-Konfigurationen (z.B. mit Nginx und MariaDB) wirf bitte einen Blick in das ``mods`` Verzeichnis des Repositories.
Diese Anleitung wird dir Schritt-für-Schritt zeigen wie du Friendica auf deinem Server installieren kannst. Falls du an automatischen Möglichkeiten Interesse hast, wirf doch einen Blick auf
Entpacke die Friendica-Daten in das Quellverzeichnis (root) des Dokumentenbereichs deines Webservers. Wenn du die Möglichkeit hierzu hast, empfehlen wir dir “git” zu nutzen, um die Daten direkt von der Quelle zu klonen, statt die gepackte .tar- oder .zip-Datei zu nutzen. Das macht die Aktualisierung wesentlich einfacher. Der Linux-Code, mit dem man die Dateien direkt in ein Verzeichnis wie “meinewebseite” kopiert, ist
git clone https://github.com/friendica/friendica.git -b stable mywebsite cd mywebsite bin/composer.phar install
Stelle sicher, dass der Ordner view/smarty3 existiert and von dem Webserver-Benutzer (z.B. www-data) beschreibbar ist
mkdir view/smarty3 chmod 755 view/smarty3
Falls Addons installiert werden sollen: Gehe in den Friendica-Ordner
cd mywebsite
Und die Addon Repository klonst:
git clone https://github.com/friendica/friendica-addons.git -b stable addon
Um das Addon-Verzeichnis aktuell zu halten, solltest du in diesem Pfad ein “git pull”-Befehl eintragen
cd meinewebseite/addon git pull
Wenn du den Verzeichnispfad auf deinen Webserver kopierst, dann stelle sicher, dass du auch die .htaccess kopierst, da “Punkt”-Dateien oft versteckt sind und normalerweise nicht direkt kopiert werden.
Wenn du die Entwickler Version von Friendica verwenden möchtest kannst du auf den develop Branch im git Repository wechseln. Dies tust du mit den folgenden Befehlen
git checkout develop bin/composer.phar install cd addon git checkout develop
Die Entwickler Version kann nach einem fehlerhaften Commit vorübergehend Probleme haben oder gar nicht mehr funktionieren. Sollte dir so etwas passieren, lass es uns bitte wissen, damit der Fehler behoben werden kann.
Erstelle eine leere Datenbank und notiere alle Zugangsdaten (Adresse der Datenbank, Nutzername, Passwort, Datenbankname).
Friendica benötigt die Berechtigungen um neue Felder in dieser Datenbank zu erstellen (create) und zu löschen (delete).
Mit neueren Versionen von MySQL (5.7.17+) musst du den sql_mode zu „“ (blank) setzen. Benutze diese Einstellung, wenn der Installer nicht in der Lage ist, die Tabellen aufgrund eines Timestamp-Format Problems zu erstellen. Falls dem so ist, finde den [mysqld] Bereich in deiner my.conf Datei und füge diese Zeile hinzu:
sql_mode = ''
Starte MySQL dann neu und es sollte klappen.
Besuche deine Webseite mit deinem Browser und befolge die Anleitung. Bevor du dies tust, kopiere die Datei .htaccess-dist nach .htaccess, wenn du den Apache Webserver verwendest. Bitte beachte jeden Fehler und korrigiere diese, bevor du fortfährst.
Falls du einen Port für die Datenbankverbindung angeben musst, kannst du diesen in der Host-Eingabe Zeile angeben.
Wenn die manuelle Installation aus irgendeinem Grund fehlschlägt, dann prüfe das Folgende:
Besuche deine Seite an diesem Punkt wieder und registriere deinen persönlichen Account. Alle Registrierungsprobleme sollten automatisch behebbar sein. Wenn du irgendwelche kritischen Fehler zu diesen Zeitpunkt erhalten solltest, deutet das darauf hin, dass die Datenbank nicht korrekt installiert wurde. Du kannst bei Bedarf die Datei config/local.config.php verschieben/umbenennen und die Datenbank leeren (als „Dropping“ bezeichnet), so dass du mit einem sauberen System neu starten kannst.
Es existieren folgende Varianten zur automatischen Installation von Friendica:
Umgebungsvariablen und Optionen können auch kombiniert werden. Dabei ist jedoch darauf zu achten, dass etwaige Optionen immer die zugehörigen Umgebungsvariablen überschreiben.
Für mehr Informationen kannst du diese Option verwenden:
bin/console autoinstall -v
Falls du alle optionalen Checks ausfürehn lassen möchtest, benutze diese Option:
bin/console autoinstall -a
Wenn die automatisierte Installation aus irgendeinem Grund fehlschlägt, dann prüfe das Folgende:
Für diese Variante muss ein Konfigurationsdatei bereits vor der Installation fertig definiert sein (z.B. local-sample.config.php.
Gehe im Anschluss in den Friendica-Hauptordner und führe den Kommandozeilen Befehl aus:
bin/console autoinstall -f <prepared.config.php>
Es existieren Zwei Arten von Umgebungsvariablen in Friendica:
Umgebungsvariablen können auch durch adäquate Optionen (z.B. –dbhost <hostname>)übersteuert werden.
Nur wenn die Option –savedb gesetzt ist, werden diese Umgebungsvariablen auch in config/local.config.php gespeichert!
MYSQL_HOST Der Host der MySQL/MariaDB DatenbankMYSQL_PORT Der Port der MySQL/MariaDB DatenbankMYSQL_USERNAME Der Benutzername des MySQL Datenbanklogins (MySql - Variante)MYSQL_USER Der Benutzername des MariaDB Datenbanklogins (MariaDB-Variante)MYSQL_PASSWORD Das Passwort der MySQL/MariaDB DatenbankloginsMYSQL_DATABASE Der Name der MySQL/MariaDB DatenbankDiese Umgebungsvariablen können nicht während des normalen Friendica Betriebs verwendet werden. Sie werden stattdessen direkt in config/local.config.php gespeichert.
FRIENDICA_PHP_PATH Der Pfad zur PHP-DateiFRIENDICA_ADMIN_MAIL Die Admin E-Mail Adresse dieses Friendica Knotens (wird auch für den Admin-Zugang benötigt)FRIENDICA_TZ Die Zeitzone von FriendicaFRIENDICA_LANG Die Sprache von FriendicaGehe im Anschluss in den Friendica-Hauptordner und führe den Kommandozeilen Befehl aus:
bin/console autoinstall [--savedb]
Alle Optionen werden in config/local.config.php gespeichert und überschreiben etwaige, zugehörige Umgebungsvariablen.
-H|–dbhost <host> Der Host der MySQL/MariaDB Datenbank (env MYSQL_HOST)-p|–dbport <port> Der Port der MySQL/MariaDB Datenbank (env MYSQL_PORT)-U|–dbuser <username> Der Benutzername des MySQL/MariaDB Datenbanklogins (env MYSQL_USER or MYSQL_USERNAME)-P|–dbpass <password> Das Passwort der MySQL/MariaDB Datenbanklogins (env MYSQL_PASSWORD)-d|–dbdata <database> Der Name der MySQL/MariaDB Datenbank (env MYSQL_DATABASE)-u|–urlpath <url_path> Der Pfad Anteil der URL unter dem Friendica installiert ist - z.B. /friendica (env `FRIENDICA_URL_PATH`)-b|–phppath <php_path> Der Pfad zur PHP-Datei (env FRIENDICA_PHP_PATH)-A|–admin <mail> Die Admin E-Mail Adresse dieses Friendica Knotens (env FRIENDICA_ADMIN_MAIL)-T|–tz <timezone> Die Zeitzone von Friendica (env FRIENDICA_TZ)-L|–lang <language> Die Sprache von Friendica (env FRIENDICA_LANG)Gehe in den Friendica-Hauptordner und führe den Kommandozeilen Befehl aus:
bin/console autoinstall [options]
Kopiere die Datei .htaccess-dist nach .htaccess damit das Apache Modul mod-rewrite funktioniert. Wenn du Friendica in ein Unterverzeichnis installiert hast, dann passe die RewriteBase entsprechend an.
Beispiel:
cp .htacces-dist .htaccess
Hinweis: Benenne die Datei .htaccess-dist nicht um, da sie vom git Repository verwaltet wird und dies zu Komplikationen mit git führen kann.
Friendica sollte automatisch auf wichtige Adressen unter dem Pfad /.well-known/ antworten. Eine kritische URL ist zum Beispiel so aussehen: https://example.com/.well-known/host-meta. Diese muss für die Öffentlichkeit sichtbar sein und mit einer XML-Datei antworten, die automatisch von Friendica generiert wird.
Wenn diese URL nicht funktioniert, ist es möglich, dass eine andere Software den Pfad /.well-known/ verwendet. Andere Symptome können eine Fehlermeldung in den Admin-Einstellungen sein, die besagt, dass „konnte von deinem System nicht aufgerufen werden. Dies deutet auf ein schwerwiegendes Problem deiner Konfiguration hin.“ Ein weiterer häufiger Fehler im Zusammenhang mit host-meta ist die „Ungültige Profil-URL“.
Sollte dies der Fall sein, prüfe ob es ein .well-known-Verzeichnis gibt, das nicht mit Friendica geliefert wurde. Die bevorzugte Konfiguration besteht darin, das Verzeichnis zu entfernen. Dies ist jedoch nicht immer möglich. Wenn es irgendeine /.known/.htaccess-Datei gibt, könnte diese die grundlegende Funktionalität von Friendica beeinträchtigen.. Sie sollten alle RewriteRules aus dieser Datei entfernen, oder gegebenenfalls die gesamte Datei entfernen.
Besuchen Sie an dieser Stelle erneut Ihre Website und registrieren Sie Ihr persönliches Konto mit derselben E-Mail wie im Konfigurationswert config.admin_email die bei der Installation eingegeben wurde. Registrierungsfehler sollten sich alle beheben lassen.
Wenn Sie zu diesem Zeitpunkt einen kritischen Fehler erhalten, deutet dies im Allgemeinen darauf hin, dass die Datenbank nicht korrekt installiert wurde. Möglicherweise möchten Sie die Datei config/local.config.php löschen/umbenennen und alle Datenbanktabellen löschen, damit Sie neu beginnen können.
Erstelle einen Cron job oder einen regelmäßigen Task, um den Poller alle 5-10 Minuten im Hintergrund ablaufen zu lassen. Beispiel:
cd /base/directory; /path/to/php bin/worker.php
Ändere “/base/directory” und “/path/to/php” auf deine Systemvorgaben.
Wenn du einen Linux-Server nutzt, benutze den Befehl “crontab -e” und ergänze eine Zeile wie die Folgende; angepasst an dein System
*/10 * * * * cd /home/myname/mywebsite; /usr/bin/php bin/worker.php
Du kannst den PHP-Pfad finden, indem du den Befehl „which php“ ausführst. Wenn du Schwierigkeiten mit diesem Schritt hast, kannst du deinen Hosting-Anbieter kontaktieren. Friendica wird nicht korrekt laufen, wenn dieser Schritt nicht erfolgreich abgeschlossen werden kann.
Bei manchen Hosting-Anbietern kommen unterschiedliche PHP-Versionen für den Webserver, die Kommandozeile und über das System gestartete PHP-Prozesse zum Einsatz. In diesem Fall kann es erforderlich sein, in der Datei local.config.php explizit den Pfad zum zu verwendenden PHP-Interpreter in geeigneter Version anzugeben:
'config' => [
'php_path' => '/usr/bin/php82',
…,
],
Alternativ zum Worker kannst du auch den Daemon als Hintergrundprozess auf dem Server ausführen lassen. Dies tust du mit folgendem Befehl:
cd /path/to/friendica; php bin/daemon.php start
Ist der Daemon einmal gestartet, kannst du mit folgendem Befehl den Status überprüfen:
cd /path/to/friendica; php bin/daemon.php status
Wird der Server neu gestartet, oder nach einem Fehler, muss der Daemon neu gestartet werden. Dies sollte mit einem Cron-Job automatisiert werden.
An dieser Stelle solltest du dir Gedanken über das Logging auf deinem Server und die automatische Rotation der Protokolle machen.
Unter den Administrations Einstellungen findest du Informationen zu den Logs von Friendica und wie man ein PHP Protokoll führen kann. Da diese Dateien groß schnell werden können, sollten sie automatisch komprimiert werden (Rotation).
Es werden schlimme Dinge geschehen. Sei es nun ein Hardwareversagen oder eine kaputte Datenbank. Deshalb solltest du dir, nachdem die Installation deines Friendica Knotens abgeschlossen ist, einen Backup Plan erstellen.
Die wichtigste Datei ist die config/local.config.php im Stammverzeichnis deiner Friendica Installation. Und da alle Daten in der Datenbank gespeichert werden, solltest du einen nicht all zu alten Dump der Friendica Datenbank zur Hand haben, solltest du deinen Knoten wieder herstellen müssen.
Friendica sucht nach einigen häufig verwendeten HTTP Headern die auf eine Reverse-Proxy-Terminierung der HTTPS hinweisen. Während der Standard aus RFC 7239 die Verwendung des Forwarded-Headers spezifiziert.
Forwarded: for=192.0.2.1; proto=https; by=192.0.2.2
Friendica unterstützt darüber hinaus auch noch einige Nicht-Standard die häufig verwendet werden.
X-Forwarded-Proto: https
Front-End-Https: on
X-Forwarded-Ssl: on
Vorzugsweise sollte aber der Standard Header verwendet werden.
Check your database settings. It usually means your database could not be opened or accessed. If the database resides on the same machine, check that the database server name is „localhost“.
This could be the result of one of our Apache directives not being supported by your version of Apache. Examine your apache server logs. You might remove the line „Options -Indexes“ from the `.htaccess` file if you are using a Windows server as this has been known to cause problems. Also check your file permissions. Your website and all contents must generally be world-readable.
It is likely that your web server reported the source of the problem in its error log files. Please review these system error logs to determine what caused the problem. Often this will need to be resolved with your hosting provider or (if self-hosted) your web server configuration.
First check your file permissions. Your website and all contents must generally be world-readable.
Ensure that mod-rewite is installed and working, and that your .htaccess file is being used. To verify the latter, create a file `test.out` containing the word „test“ in the top directory of Friendica, make it world readable and point your web browser to
http://example.com/test.out
This file should be blocked. You should get a permission denied message.
If you see the word „test“ your Apache configuration is not allowing your .htaccess file to be used (there are rules in this file to block access to any file with .out at the end, as these are typically used for system logs).
Make certain the .htaccess file exists and is readable by everybody, then look for the existence of „AllowOverride None“ in the Apache server configuration for your site. This will need to be changed to „AllowOverride All“.
If you do not see the word „test“, your .htaccess is working, but it is likely that mod-rewrite is not installed in your web server or is not working.
On most Linux flavors:
% a2enmod rewrite % /etc/init.d/apache2 restart
Consult your hosting provider, experts on your particular Linux distribution or (if Windows) the provider of your Apache server software if you need to change either of these and can not figure out how. There is a lot of help available on the web. Search „mod-rewrite“ along with the name of your operating system distribution or Apache package (if using Windows).
Create an empty `config/local.config.php`file and apply world-write permission.
On Linux:
% touch config/local.config.php % chmod 664 config/local.config.php
Retry the installation. As soon as the database has been created,
this is important
% chmod 644 config/local.config.php
Some configurations with „suhosin“ security are configured without an ability to run external processes. Friendica requires this ability. Following are some notes provided by one of our members.
On my server I use the php protection system Suhosin.
One of the things it does is to block certain functions likeproc_open, as configured in/etc/php5/conf.d/suhosin.ini:
suhosin.executor.func.blacklist = proc_open, …
For those sites like Friendica that really need these functions they can be enabled, e.g. in/etc/apache2/sites-available/friendica:
<Directory /var/www/friendica/> php_admin_value suhosin.executor.func.blacklist none php_admin_value suhosin.executor.eval.blacklist none </Directory>
This enables every function for Friendica if accessed via browser, but not for the cronjob that is called via php command line. I attempted to enable it for cron by using something like:
*/10 * * * * cd /var/www/friendica/friendica/ && sudo -u www-data /usr/bin/php \ -d suhosin.executor.func.blacklist=none \ -d suhosin.executor.eval.blacklist=none -f bin/worker.php
This worked well for simple test cases, but the friendica-cron still failed with a fatal error:
suhosin[22962]: ALERT - function within blacklist called: proc_open() (attacker 'REMOTE_ADDR not set', file '/var/www/friendica/friendica/boot.php', line 1341)
After a while I noticed, thatbin/worker.phpcalls further PHP script viaproc_open. These scripts themselves also useproc_openand fail, because they are NOT called with-d suhosin.executor.func.blacklist=none.
So the simple solution is to put the correct parameters intoconfig/local.config.php:
'config' => [ //Location of PHP command line processor 'php_path' => '/usr/bin/php -d suhosin.executor.func.blacklist=none -d suhosin.executor.eval.blacklist=none', ],
If the setup fails to create all the database tables and/or manual creation from the command line fails, with this error:
ERROR 1067 (42000) at line XX: Invalid default value for 'created'
You need to adjust your my.cnf and add the following setting under the [mysqld] section:
sql_mode = '';
After that, restart mysql and try again.
ssl_policy in der config/local.config.php auf 0 setzen nachdem der Installations-Assistent durchgelaufen ist. Aber mach das niemals für eine Friendica Instanz im Produktiven Einsatz!