From a7cbca6e6edb86826d81f4df7b0a3daa6d09643b Mon Sep 17 00:00:00 2001 From: Morris Jobke Date: Fri, 13 May 2016 03:35:18 +0200 Subject: [PATCH] generate documentation from config.sample.php --- .../config_sample_php_parameters.rst | 26 +++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/admin_manual/configuration_server/config_sample_php_parameters.rst b/admin_manual/configuration_server/config_sample_php_parameters.rst index c081d4800..1bc3af3dd 100644 --- a/admin_manual/configuration_server/config_sample_php_parameters.rst +++ b/admin_manual/configuration_server/config_sample_php_parameters.rst @@ -456,6 +456,32 @@ are generated within ownCloud using any kind of command line tools (cron or occ). The value should contain the full base URL: ``https://www.example.com/owncloud`` +:: + + 'htaccess.RewriteBase' => '/', + +To have clean URLs without `/index.php` this parameter needs to be configured. + +This parameter will be written as "RewriteBase" on update and installation of +ownCloud to your `.htaccess` file. While this value is often simply the URL +path of the ownCloud installation it cannot be set automatically properly in +every scenario and needs thus some manual configuration. + +In a standard Apache setup this usually equals the folder that ownCloud is +accessible at. So if ownCloud is accessible via "https://mycloud.org/owncloud" +the correct value would most likely be "/owncloud". If ownCloud is running +under "https://mycloud.org/" then it would be "/". + +Note that above rule is not valid in every case, there are some rare setup +cases where this may not apply. However, to avoid any update problems this +configuration value is explicitly opt-in. + +After setting this value run `occ maintenance:update:htaccess` and when following +conditions are met ownCloud uses URLs without index.php in it: + +- `mod_rewrite` is installed +- `mod_env` is installed + :: 'proxy' => '',