Depending on your hosting environment, permissions may or may not be an issue you need to concern yourself with. The important thing to understand is that there is a potential issue if the user you use to edit your files on the file-system is different from the user that PHP runs under (usually the webserver), or at the very least, the two users don't have Read/Write access to these files.
First, find out which user Apache or Nginx runs with by running the following command For Apache:
ps aux | grep -v root | grep apache | cut -d\ -f1 | sort | uniq
ps aux | grep -v root | grep nginx | cut -d\ -f1 | sort | uniq
And find out which user owns the file in your grav directory by running
Being a file-based CMS, Grav needs to write to the file-system in order to create cache and log files. There are three main scenarios:
This is the approach used by most shared hosting setups and also works well for local development. The blog post we wrote regarding MacOS Yosemite, Apache, and PHP outlines how to configure Apache to run as your personal user account. This approach is not considered secure enough to use on a dedicated web host, so the second or third option should be used.
By using a shared Group between your user and PHP/Webserver account with
664 permissions you ensure that even though you have two different accounts, both will have Read/Write access to the files. You should also probably set a
umask 0002 on the root so that new files are created with the proper permissions.
The last approach is to have completely different accounts and just update the ownership and permissions of the files after editing to ensure that the PHP/Webserver user can Read/Write appropriately.
A simple permissions-fixing shell script can be used to do this:
#!/bin/sh chown -R joeblow:staff . find . -type f | xargs chmod 664 find ./bin -type f | xargs chmod 775 find . -type d | xargs chmod 775 find . -type d | xargs chmod +s
You can use this file and edit as needed for the appropriate user and group that works for your setup. What this script basically does, is:
664so they are
RWfor User & Group and
775so they are
RWXfor User & Group and
If image files in the cache folder are written with the wrong permissions, try setting in your
images: cache_perms: '0775'
images property is already present, just add
cache_perms: '0775' at the end of it.
If this does still not work, create a
setup.php file in the root Grav folder (the one with
index.php), and add
If you already have a
setup.php file, just add this line to the top. This file is commonly used for multisite setup, but being called in every Grav call, you can also use it for other uses.
In general, Grav can be installed in a root level folder of an existing WordPress site and the two CMS will co-exist nicely. (Remember to set Base Rewrite in the Grav folder's htaccess.) If you are encountering permissions errors with cache files when accessing the Admin and/or viewing Grav pages, check to see if WP-Engine is installed for this WordPress site. If it is, you will need to contact their support to create an exception for the Grav folder from their aggressive distributed cache service.
If the above suggestions still do not work, run
chcon -Rv system_u:object_r:httpd_sys_rw_content_t:s0 ./ into the Grav root folder.
Found errors? Think you can improve this documentation? Simply click the Edit link at the top of the page, and then the icon on Github to make your changes.