diff --git a/doc/Install.md b/doc/Install.md index bd8a0ad74c..300a9c82d3 100644 --- a/doc/Install.md +++ b/doc/Install.md @@ -147,12 +147,19 @@ Example: ### Verify the "host-meta" page is working -Friendica should respond automatically to an important address named /.well-known/host-meta This 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. +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 +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 and is not configured correctly to work with Friendica. Other symptoms may include an error message in the Admin settings that says "host-meta is not reachable on your system. This is a severe configuration issue that prevents communication." Another common error related to host-meta is the, "Invalid profile URL." - -Check for a .well-known directory that did not come with Friendica. Any /.well-known/.htaccess file could interfere with this core requirement. You should remove any RewriteRules from that file, or remove that whole file if appropriate. +If that URL is not working, it is possible that some other software is using the /.well-known/ path. +Other symptoms may include an error message in the Admin settings that says "host-meta is not reachable on your system. +This is a severe configuration issue that prevents server to server communication." +Another common error related to host-meta is the "Invalid profile URL." +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. +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. It may be necessary to chmod the /.well-known/.htaccess file if you were not given write permissions by default. ### Set up the worker