Skip to content

Commit

Permalink
Update directory permissions to make var/ writable
Browse files Browse the repository at this point in the history
Simplifies the directory permission commands to make sure:
- session folder is writable
- other custom var/ sub folders are writeable, typically data / storage / upload folder needed cms/crm/ecommerce/pim/.. systems built on top of symfony, avoiding that these projects needs to have own conflicting documentation on this

Closes #6132
  • Loading branch information
andrerom committed Jan 12, 2016
1 parent 2db6e18 commit f18a1aa
Showing 1 changed file with 8 additions and 9 deletions.
17 changes: 8 additions & 9 deletions book/installation.rst
Expand Up @@ -220,9 +220,9 @@ If there are any issues, correct them now before moving on.

.. sidebar:: Setting up Permissions

One common issue when installing Symfony is that the ``var/cache`` and
``var/logs`` directories must be writable both by the web server and the
command line user. On a UNIX system, if your web server user is different
One common issue when installing Symfony is that the ``var/cache``, ``var/logs``
and ``var/sessions`` directories must be writable both by the web server and
the command line user. On a UNIX system, if your web server user is different
from your command line user, you can try one of the following solutions.

**1. Use the same user for the CLI and the web server**
Expand All @@ -242,12 +242,11 @@ If there are any issues, correct them now before moving on.

.. code-block:: bash
$ rm -rf var/cache/*
$ rm -rf var/logs/*
$ rm -rf var/cache/* var/logs/* var/sessions/*
$ HTTPDUSER=`ps axo user,comm | grep -E '[a]pache|[h]ttpd|[_]www|[w]ww-data|[n]ginx' | grep -v root | head -1 | cut -d\ -f1`
$ sudo chmod +a "$HTTPDUSER allow delete,write,append,file_inherit,directory_inherit" var/cache var/logs
$ sudo chmod +a "`whoami` allow delete,write,append,file_inherit,directory_inherit" var/cache var/logs
$ sudo chmod +a "$HTTPDUSER allow delete,write,append,file_inherit,directory_inherit" var
$ sudo chmod +a "`whoami` allow delete,write,append,file_inherit,directory_inherit" var
**3. Using ACL on a system that does not support chmod +a**
Expand All @@ -261,8 +260,8 @@ If there are any issues, correct them now before moving on.
.. code-block:: bash
$ HTTPDUSER=`ps axo user,comm | grep -E '[a]pache|[h]ttpd|[_]www|[w]ww-data|[n]ginx' | grep -v root | head -1 | cut -d\ -f1`
$ sudo setfacl -R -m u:"$HTTPDUSER":rwX -m u:`whoami`:rwX var/cache var/logs
$ sudo setfacl -dR -m u:"$HTTPDUSER":rwX -m u:`whoami`:rwX var/cache var/logs
$ sudo setfacl -R -m u:"$HTTPDUSER":rwX -m u:`whoami`:rwX var
$ sudo setfacl -dR -m u:"$HTTPDUSER":rwX -m u:`whoami`:rwX var
If this doesn't work, try adding ``-n`` option.

Expand Down

0 comments on commit f18a1aa

Please sign in to comment.