X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=INSTALL.txt;h=a9d42495bcc70d35f4c9b23ebc0a0bdf3077226b;hb=e5c2c66487eceea38d7fbe792238991084718bd8;hp=c36c846a18981f865ddf88b4594444a51589eebc;hpb=a71e3134bf7250b60cafd1e51098eea70c3459de;p=friendica.git diff --git a/INSTALL.txt b/INSTALL.txt index c36c846a18..a9d42495bc 100644 --- a/INSTALL.txt +++ b/INSTALL.txt @@ -32,8 +32,7 @@ link if your cert is self-signed). - Apache with mod-rewrite enabled and "Options All" so you can use a local .htaccess file - - PHP 5.2+. The later the better. PHP 5.3 is required for communications -with the Diaspora network and improved security. + - PHP 5.4+. - PHP *command line* access with register_argc_argv set to true in the php.ini file [or see 'poormancron' in section 8] @@ -42,7 +41,7 @@ php.ini file [or see 'poormancron' in section 8] - some form of email server or email gateway such that PHP mail() works - - Mysql 5.x + - Mysql 5.5.3+ or an equivalant alternative for MySQL (MariaDB, Percona Server etc.) - ability to schedule jobs with cron (Linux/Mac) or Scheduled Tasks (Windows) [Note: other options are presented in Section 8 of this document] @@ -51,6 +50,10 @@ php.ini file [or see 'poormancron' in section 8] directory/path component in the URL) is preferred. This is REQUIRED if you wish to communicate with the Diaspora network. + + - For alternative server configurations (such as Nginx server and MariaDB + database engine), refer to the wiki at https://github.com/friendica/friendica/wiki + 2. Unpack the Friendica files into the root of your web server document area. - If you copy the directory tree to your webserver, make sure @@ -60,6 +63,8 @@ you wish to communicate with the Diaspora network. 3. Create an empty database and note the access details (hostname, username, password, database name). + - Friendica needs the permission to create and delete fields and tables in its own database. + 4. If you know in advance that it will be impossible for the web server to write or create files in your web directory, create an empty file called @@ -130,8 +135,25 @@ $a->config['system']['addon'] = 'js_upload,poormancron'; and save your changes. +9. (Optional) Reverse-proxying and HTTPS + +Friendica looks for some well-known HTTP headers indicating a reverse-proxy +terminating an HTTPS connection. While the standard from RFC 7239 specifies +the use of the `Forwaded` header. + + Forwarded: for=192.0.2.1; proto=https; by=192.0.2.2 + +Friendica also supports a number on non-standard headers in common use. + + + X-Forwarded-Proto: https + + Front-End-Https: on + + X-Forwarded-Ssl: on + +It is however preferable to use the standard approach if configuring a new server. - ##################################################################### If things don't work...