diff --git a/admin_manual/installation/index.rst b/admin_manual/installation/index.rst index b7f8fe3f3..9baa3d705 100644 --- a/admin_manual/installation/index.rst +++ b/admin_manual/installation/index.rst @@ -14,6 +14,7 @@ Installation macos_installation nginx_configuration others_installation + selinux_configuration source_installation ucs_installation windows_installation diff --git a/admin_manual/installation/linux_installation.rst b/admin_manual/installation/linux_installation.rst index a48e6574e..07b2d34a0 100644 --- a/admin_manual/installation/linux_installation.rst +++ b/admin_manual/installation/linux_installation.rst @@ -1,8 +1,9 @@ +=================== Linux Distributions -------------------- +=================== Supported Distribution Packages -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +------------------------------- Ready-to-use packages are available at `openSUSE Build Service`_ for a variety of Linux distributions. @@ -11,12 +12,10 @@ If your distribution is not listed please follow :doc:`source_installation`. .. _openSUSE Build Service: http://software.opensuse.org/download.html?project=isv:ownCloud:community&package=owncloud -Additional installation guides and notes -**************************************** - -**Fedora:** Make sure `SELinux is disabled `_ -or else the installation process might fail. +Additional Installation Guides and Notes +---------------------------------------- +See :doc:`selinux_configuration` for a suggested configuration for SELinux-enabled distributions such as Fedora and CentOS. **Archlinux:** The are two packages for ownCloud: `stable version`_ in the official community repository and `development version`_ in AUR. @@ -28,8 +27,8 @@ or else the installation process might fail. .. _ownCloud, installation and setup: http://pclinuxoshelp.com/index.php/Owncloud,_installation_and_setup -Follow the wizard to complete your installation -*********************************************** +Installation Wizard +------------------- For setting up your ownCloud instance after installation, please refer to the :doc:`installation_wizard` section. diff --git a/admin_manual/installation/selinux_configuration.rst b/admin_manual/installation/selinux_configuration.rst new file mode 100644 index 000000000..c43516b78 --- /dev/null +++ b/admin_manual/installation/selinux_configuration.rst @@ -0,0 +1,36 @@ +===================== +SELinux Configuration +===================== + +When you have SELinux enabled on your Linux distribution, you may run into +permissions problems after a new ownCloud installation, and see ``permission +denied`` errors in your ownCloud logs. + +The following settings should work for most SELinux systems that use the +default distro profiles. Run these commands as root, and remember to adjust the filepaths +in these examples for your installation:: + + semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/html/owncloud/data' + restorecon '/var/www/html/owncloud/data' + semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/html/owncloud/config' + restorecon '/var/www/html/owncloud/config' + semanage fcontext -a -t httpd_sys_rw_content_t '/var/www/html/owncloud/apps' + restorecon '/var/www/html/owncloud/apps' + +If you uninstall ownCloud you need to remove the ownCloud directory labels. To do +this execute the following commands as root after uninstalling ownCloud:: + + semanage fcontext -d -t httpd_sys_rw_content_t '/var/www/html/owncloud/data' + restorecon '/var/www/html/owncloud/data' + semanage fcontext -d -t httpd_sys_rw_content_t '/var/www/html/owncloud/config' + restorecon '/var/www/html/owncloud/config' + semanage fcontext -d -t httpd_sys_rw_content_t '/var/www/html/owncloud/apps' + restorecon '/var/www/html/owncloud/apps' + +If you have customized SELinux policies and these examples do not work, you must give the +HTTP server write access to these directories:: + + /var/www/html/owncloud/data + /var/www/html/owncloud/config + /var/www/html/owncloud/apps +