nupplaPhil/friendica
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity

minor formatting adjustments

Browse source
This commit is contained in:
guzzisti 2019-07-11 21:26:51 +02:00
parent 3f09ecc3e1
commit 999a82e58b
1 changed files with 11 additions and 8 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
doc/Install.md
View file

@ -4,12 +4,15 @@
We've tried very hard to ensure that Friendica will run on commodity hosting platforms - such as those used to host Wordpress blogs and Drupal websites. We've tried very hard to ensure that Friendica will run on commodity hosting platforms - such as those used to host Wordpress blogs and Drupal websites.
We offer a manual and an automatic installation. We offer a manual and an automatic installation.
But be aware that Friendica is more than a simple web application. But be aware that Friendica is more than a simple web application.
It is a complex communications system which more closely resembles an email server than a web server. It is a complex communications system which more closely resembles an email server than a web server.
For reliability and performance, messages are delivered in the background and are queued for later delivery when sites are down. For reliability and performance, messages are delivered in the background and are queued for later delivery when sites are down.
This kind of functionality requires a bit more of the host system than the typical blog. This kind of functionality requires a bit more of the host system than the typical blog.
Not every PHP/MySQL hosting provider will be able to support Friendica. Not every PHP/MySQL hosting provider will be able to support Friendica.
Many will. Many will.
But **please** review the requirements and confirm these with your hosting provider prior to installation.
But **please** review the [requirements](#1_2_1) and confirm these with your hosting provider prior to installation.
## Support ## 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). 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).
@ -79,7 +82,7 @@ Make sure the folder *view/smarty3* exists and is writable by the webserver user
mkdir view/smarty3 mkdir view/smarty3
chown www-data:www-data view/smarty3 chown www-data:www-data view/smarty3
chmod 775 view/smarty3 chmod 775 view/smarty3
F
Get the addons by going into your website folder. Get the addons by going into your website folder.
cd mywebsite cd mywebsite
@ -105,7 +108,7 @@ 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. Friendica needs the permission to create and delete fields and tables in its own database.
Please check the [troubleshooting](#troubleshooting) section if running on MySQ 5.7.17 or newer. Please check the [troubleshooting](#1_6) section if running on MySQ 5.7.17 or newer.
### Option A: Run the installer ### Option A: Run the installer
@ -211,18 +214,18 @@ Navigate to the main Friendica directory and execute the following command:
### Prepare .htaccess file ### Prepare .htaccess file
Copy `.htaccess-dist` to `.htaccess` (be careful under Windows) to have working mod-rewrite again. If you have installed Friendica into a sub directory, like /friendica/ set this path in RewriteBase accordingly. Copy `.htaccess-dist` to `.htaccess` (be careful under Windows) to have working mod-rewrite again. If you have installed Friendica into a sub directory, like */friendica/* set this path in `RewriteBase` accordingly.
Example: Example:
cp .htacces-dist .htaccess cp .htacces-dist .htaccess
*Note*: Do **not** rename the .htaccess-dist file as it is tracked by GIT and renaming will cause a dirty working directory. *Note*: Do **not** rename the `.htaccess-dist` file as it is tracked by GIT and renaming will cause a dirty working directory.
### Verify the "host-meta" page is working ### Verify the "host-meta" page is working
Friendica should respond automatically to important addresses under the /.well-known/ rewrite path. Friendica should respond automatically to important addresses under the */.well-known/* rewrite path.
One critical URL would look like, for example, https://example.com/.well-known/host-meta One critical URL would look like, for example: https://example.com/.well-known/host-meta
It must be visible to the public and must respond with an XML file that is automatically customized to your site. It must be visible to the public and must respond with an XML file that is automatically customized to your site.
If that URL is not working, it is possible that some other software is using the /.well-known/ path. If that URL is not working, it is possible that some other software is using the /.well-known/ path.
@ -230,7 +233,7 @@ Other symptoms may include an error message in the Admin settings that says "hos
This is a severe configuration issue that prevents server to server communication." This is a severe configuration issue that prevents server to server communication."
Another common error related to host-meta is the "Invalid profile URL." Another common error related to host-meta is the "Invalid profile URL."
Check for a .well-known directory that did not come with Friendica. Check for a `.well-known` directory that did not come with Friendica.
The preferred configuration is to remove the directory, however this is not always possible. The preferred configuration is to remove the directory, however this is not always possible.
If there is any /.well-known/.htaccess file, it could interfere with this Friendica core requirement. If there is any /.well-known/.htaccess file, it could interfere with this Friendica core requirement.
You should remove any RewriteRules from that file, or remove that whole file if appropriate. You should remove any RewriteRules from that file, or remove that whole file if appropriate.