X-Git-Url: https://git.mxchange.org/?a=blobdiff_plain;f=doc%2FInstall.md;h=6aa094ffce74753b2960af23969072a81bdb96d0;hb=c30089eb6f4f9547895d40caee144f81ff3a4e95;hp=531ee08b6ba8dc9573154608ade2a07b69f1b746;hpb=999a82e58b5e3b6bc207fa33d90062f302863548;p=friendica.git diff --git a/doc/Install.md b/doc/Install.md index 531ee08b6b..6aa094ffce 100644 --- a/doc/Install.md +++ b/doc/Install.md @@ -12,7 +12,7 @@ This kind of functionality requires a bit more of the host system than the typic Not every PHP/MySQL hosting provider will be able to support Friendica. Many will. -But **please** review the [requirements](#1_2_1) and confirm these with your hosting provider prior to installation. +But **please** review the [requirements](#Requirements) and confirm these with your hosting provider prior to installation. ## Support If you encounter installation issues, please let us know via the [helper](http://forum.friendi.ca/profile/helpers) or the [developer](https://forum.friendi.ca/profile/developers) forum or [file an issue](https://github.com/friendica/friendica/issues). @@ -26,14 +26,14 @@ The account will expire after 7 days, but you can ask the server admin to keep y ## Prerequisites * Choose a domain name or subdomain name for your server. Put some thought into this. While changing it after installation is supported, things still might break. -* Setup HTTPS on your host. +* Setup HTTPS on your domain. ### Requirements -* Apache with mod-rewrite enabled and "Options All" so you can use a local .htaccess file +* Apache with mod-rewrite enabled and "Options All" so you can use a local `.htaccess` file * PHP 7+ (PHP 7.1+ is recommended for performance and official support) * PHP *command line* access with register_argc_argv set to true in the php.ini file - * Curl, GD, PDO, MySQLi, hash, xml, zip and OpenSSL extensions + * Curl, GD, PDO, mbstrings, MySQLi, hash, xml, zip and OpenSSL extensions * The POSIX module of PHP needs to be activated (e.g. [RHEL, CentOS](http://www.bigsoft.co.uk/blog/index.php/2014/12/08/posix-php-commands-not-working-under-centos-7) have disabled it) * some form of email server or email gateway such that PHP mail() works * MySQL 5.6+ or an equivalent alternative for MySQL (MariaDB, Percona Server etc.) @@ -47,7 +47,6 @@ For alternative server configurations (such as Nginx server and MariaDB database ### Optional * PHP ImageMagick extension (php-imagick) for animated GIF support. -* [Composer](https://getcomposer.org/) for a git install ## Installation procedure @@ -61,10 +60,11 @@ If this is nothing for you, you might be interested in ### Get Friendica +Download the full archive of the stable release of Friendica core and the addons from [the project homepage](https://friendi.ca/resources/download-files/). +Make sure that the version of the Friendica archive and the addons match. Unpack the Friendica files into the root of your web server document area. -If you copy the directory tree to your webserver, make sure that you also copy -`.htaccess-dist` - as "dot" files are often hidden and aren't normally copied. +If you copy the directory tree to your webserver, make sure that you also copy `.htaccess-dist` - as "dot" files are often hidden and aren't normally copied. **OR** @@ -73,23 +73,23 @@ This makes the software much easier to update. The Linux commands to clone the repository into a directory "mywebsite" would be - git clone https://github.com/friendica/friendica.git -b master mywebsite + git clone https://github.com/friendica/friendica.git -b stable mywebsite cd mywebsite bin/composer.phar install --no-dev Make sure the folder *view/smarty3* exists and is writable by the webserver user, in this case *www-data* - mkdir view/smarty3 + mkdir -p view/smarty3 chown www-data:www-data view/smarty3 chmod 775 view/smarty3 -F + Get the addons by going into your website folder. cd mywebsite Clone the addon repository (separately): - git clone https://github.com/friendica/friendica-addons.git -b master addon + git clone https://github.com/friendica/friendica-addons.git -b stable addon If you want to use the development version of Friendica you can switch to the develop branch in the repository by running @@ -108,11 +108,12 @@ Create an empty database and note the access details (hostname, username, passwo Friendica needs the permission to create and delete fields and tables in its own database. -Please check the [troubleshooting](#1_6) section if running on MySQ 5.7.17 or newer. +Please check the [troubleshooting](#Troubleshooting) section if running on MySQL 5.7.17 or newer. ### Option A: Run the installer -Point your web browser to the new site and follow the instructions. +Before you point your web browser to the new site you need to copy `.htaccess-dist` to `.htaccess` for Apache installs. +Follow the instructions. Please note any error messages and correct these before continuing. If you need to specify a port for the connection to the database, you can do so in the host name setting for the database. @@ -153,7 +154,7 @@ If you wish to include all optional checks, use `-a` like this statement: #### B.1: Config file -You can use a prepared config file like [local-sample.config.php](config/local-sample.config.php). +You can use a prepared config file like [local-sample.config.php](/config/local-sample.config.php). Navigate to the main Friendica directory and execute the following command: @@ -258,7 +259,7 @@ Example: Change "/base/directory", and "/path/to/php" as appropriate for your situation. -#### cron job for Worker +#### cron job for worker If you are using a Linux server, run "crontab -e" and add a line like the one shown, substituting for your unique paths and settings: @@ -328,7 +329,7 @@ If the database resides on the same machine, check that the database server name ### 500 Internal Error 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. +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. @@ -435,7 +436,7 @@ provided by one of our members. > > This is obvious as soon as you notice that the friendica-cron uses `proc_open` > to execute PHP scripts that also use `proc_open`, but it took me quite some time to find that out. -> I hope this saves some time for other people using suhosin with function blacklists. +> I hope this saves some time for other people using suhosin with function blocklists. ### Unable to create all mysql tables on MySQL 5.7.17 or newer