Nginx not following symlinks

Neo picture Neo · Sep 27, 2012 · Viewed 94.9k times · Source

I have installed nginx on Ubuntu 12.04. However, nginx does not seem to follow symlinks. I understand that there is a config change required for this but I am not able to find where to make the change. Any help appreciated.

Answer

oHo picture oHo · Mar 7, 2013

In my case nginx was already configured to follow symbolic links. But the issue was the user nginx could not access my home files and therefore symbolic link to my home directory was not working.

Example

Suppose we have symbolic link /usr/share/nginx/www/mylink -> /home/u/html

cd /usr/share/nginx/www
mkdir   -p  /home/u/html
sudo ln -sv /home/u/html mylink  # creates mylink -> /home/u/html

Give permissions

Give the read and execute permissions using chmod and find:

chmod +rx /home/u
chmod +rw /home/u/html
find /home/u/html/php -type d -exec chmod +rx {} +
find /home/u/html/php -type d -exec chmod +w  {} +  # optional

Notes:

  1. The permission x is named execute. But when applied to a directory, this permission allows to recurse the directory tree (see Unix modes).

  2. The command find ... -exec chmod ... recursively changes the permissions. We could also use the command chmod -R +rx /home/myuser/html but this last command also gives the execution permission to all regular files, and we do not want that. The option -type d execute chmod to only directories.

  3. The last optional command gives write permission if your PHP scripts require to write data. Try to limit write permission to only required directories for security reasons.

Test

No need to restart ngnix, just press Ctrl+F5 in your browser.

Caution: It is not recommended to create symbolic links pointing to your home directory because a mistake on read/write access or a wrong symbolic link may expose your digital data...

Reference: Arch wiki on nginx