Setting up SFTP with Nginx - Revision history

Planetoid at 06:12, 18 April 2025

2025-04-18T06:12:10Z

← Older revision		Revision as of 14:12, 18 April 2025
Line 1:		Line 1:

	= Nginx Directory Permissions and Symbolic Link Configuration Guide =		Nginx Directory Permissions and Symbolic Link Configuration Guide


Line 19:		Line 19:
	# Verify Symbolic Link		# Verify Symbolic Link

	<~~syntaxhighlight~~ lang="bash"># Check if symbolic link is correct		<pre lang="bash"># Check if symbolic link is correct
	ls -l /home/your_user/public_folder</~~syntaxhighlight~~>		ls -l /home/your_user/public_folder</pre>
	Expected output:		Expected output:

Line 52:		Line 52:
	}</pre>		}</pre>
	<span id="common-issues"></span>		<span id="common-issues"></span>
	== Common Issues: ==		== Troubleshooting of Common Issues ==

	* Specific directories return 404 (files exist)		* Specific directories return 404 (files exist)
Line 58:		Line 58:
	* Nginx error log shows permission issues		* Nginx error log shows permission issues

	== Solution: Adjust Permission Settings ==		=== Solution: Adjust Permission Settings ===

	# Check Nginx Error Log		# Check Nginx Error Log
Line 82:		Line 82:
	chmod 644 /usr/share/nginx/html/folder/your_file.png</pre>		chmod 644 /usr/share/nginx/html/folder/your_file.png</pre>
	<span id="permission-details"></span>		<span id="permission-details"></span>
	== Permission Details ==
			=== Permission Details ===

	* <code>chmod 755</code> (directories):		* <code>chmod 755</code> (directories):
Line 93:		Line 94:
	** Others: read (r–)		** Others: read (r–)

	== Testing and Verification ==		=== Testing and Verification ===

	<ol style="list-style-type: decimal;">		<ol style="list-style-type: decimal;">
Line 101:		Line 102:
	sudo systemctl reload nginx</pre></li></ol>		sudo systemctl reload nginx</pre></li></ol>

	== Important Notes ==		=== Important Notes ===

	# Permission changes take effect immediately, no nginx restart needed		# Permission changes take effect immediately, no nginx restart needed

Planetoid at 06:05, 22 January 2025

2025-01-22T06:05:40Z

← Older revision		Revision as of 14:05, 22 January 2025
Line 27:		Line 27:
	<li>Check Directory Structure and Permissions</li></ol>		<li>Check Directory Structure and Permissions</li></ol>

	<~~syntaxhighlight~~ lang="bash"># Check website root directory		<pre lang="bash"># Check website root directory
	sudo ls -lht /usr/share/nginx/html/		sudo ls -lht /usr/share/nginx/html/
	# Check target directory		# Check target directory
	sudo ls -lht /usr/share/nginx/html/folder/</~~syntaxhighlight~~>		sudo ls -lht /usr/share/nginx/html/folder/</pre>
	<ol start="3" style="list-style-type: decimal;">		<ol start="3" style="list-style-type: decimal;">
	<li>Check Nginx Configuration</li></ol>		<li>Check Nginx Configuration</li></ol>

	<~~syntaxhighlight~~ lang="bash"># Check nginx config		<pre lang="bash"># Check nginx config
	sudo nano /etc/nginx/nginx.conf		sudo nano /etc/nginx/nginx.conf
	# Or check site config		# Or check site config
	sudo nano /etc/nginx/sites-available/default</~~syntaxhighlight~~>		sudo nano /etc/nginx/sites-available/default</pre>
	Basic nginx configuration should include:		Basic nginx configuration should include:

	<~~syntaxhighlight~~ lang="nginx">server {		<pre lang="nginx">server {
	listen 80;		listen 80;
	server_name your_domain;		server_name your_domain;
Line 50:		Line 50:
	try_files $uri $uri/ =404;		try_files $uri $uri/ =404;
	}		}
	}</~~syntaxhighlight~~>		}</pre>
	<span id="common-issues"></span>		<span id="common-issues"></span>
	== Common Issues: ==		== Common Issues: ==
Line 62:		Line 62:
	# Check Nginx Error Log		# Check Nginx Error Log

	<~~syntaxhighlight~~ lang="bash">sudo tail /var/log/nginx/error.log</~~syntaxhighlight~~>		<pre lang="bash">sudo tail /var/log/nginx/error.log</pre>
	Possible error message:		Possible error message:

Line 69:		Line 69:
	<li>Set User Directory Permissions</li></ol>		<li>Set User Directory Permissions</li></ol>

	<~~syntaxhighlight~~ lang="bash"># Ensure user directory is accessible		<pre lang="bash"># Ensure user directory is accessible
	sudo chmod 755 /home/your_user</~~syntaxhighlight~~>		sudo chmod 755 /home/your_user</pre>
	<ol start="3" style="list-style-type: decimal;">		<ol start="3" style="list-style-type: decimal;">
	<li>Set Website Directory Permissions</li></ol>		<li>Set Website Directory Permissions</li></ol>

	<~~syntaxhighlight~~ lang="bash"># Ensure website directory is accessible		<pre lang="bash"># Ensure website directory is accessible
	sudo chmod 755 /home/your_user/public_folder</~~syntaxhighlight~~>		sudo chmod 755 /home/your_user/public_folder</pre>
	<ol start="4" style="list-style-type: decimal;">		<ol start="4" style="list-style-type: decimal;">
	<li>(optional) Set File Permissions</li></ol>		<li>(optional) Set File Permissions</li></ol>

	<~~syntaxhighlight~~ lang="bash"># Set file read permissions		<pre lang="bash"># Set file read permissions
	chmod 644 /usr/share/nginx/html/folder/your_file.png</~~syntaxhighlight~~>		chmod 644 /usr/share/nginx/html/folder/your_file.png</pre>
	<span id="permission-details"></span>		<span id="permission-details"></span>
	== Permission Details ==		== Permission Details ==
Line 98:		Line 98:
	<li><p>Public URL format: <nowiki>http://your_domain/folder/file.png</nowiki></p></li>		<li><p>Public URL format: <nowiki>http://your_domain/folder/file.png</nowiki></p></li>
	<li><p>If still inaccessible after configuration:</p>		<li><p>If still inaccessible after configuration:</p>
	<~~syntaxhighlight~~ lang="bash"># Reload nginx configuration		<pre lang="bash"># Reload nginx configuration
	sudo systemctl reload nginx</~~syntaxhighlight~~></li></ol>		sudo systemctl reload nginx</pre></li></ol>

	== Important Notes ==		== Important Notes ==

Planetoid: Created page with " = Nginx Directory Permissions and Symbolic Link Configuration Guide = == Environment Overview == * Using SFTP to upload files to personal directory * Personal directory linked to website root via symbolic link * Files accessible through public web URL after upload === Example SFTP Upload Process === # Upload file to personal directory: `/home/your_user/public_folder/` # File automatically reflects in website directory: `/usr/share/nginx/html/folder/..."`


2025-01-20T05:42:56Z
Created page with " = Nginx Directory Permissions and Symbolic Link Configuration Guide =   == Environment Overview ==  * Using SFTP to upload files to personal directory * Personal directory linked to website root via symbolic link * Files accessible through public web URL after upload  === Example SFTP Upload Process ===  # Upload file to personal directory: <code>/home/your_user/public_folder/</code> # File automatically reflects in website directory: <code>/usr/share/nginx/html/folder/..."
New page


= Nginx Directory Permissions and Symbolic Link Configuration Guide =





== Environment Overview ==



* Using SFTP to upload files to personal directory

* Personal directory linked to website root via symbolic link

* Files accessible through public web URL after upload



=== Example SFTP Upload Process ===



# Upload file to personal directory: <code>/home/your_user/public_folder/</code>

# File automatically reflects in website directory: <code>/usr/share/nginx/html/folder/</code>

# Access via URL: <nowiki>http://your_domain/folder/file.png</nowiki>



== Configuration Steps ==



# Verify Symbolic Link



<syntaxhighlight lang="bash"># Check if symbolic link is correct

ls -l /home/your_user/public_folder</syntaxhighlight>

Expected output:



<pre>lrwxrwxrwx 1 your_user your_user 26 Jan 20 15:00 /home/your_user/public_folder -&gt; /usr/share/nginx/html/folder</pre>

<ol start="2" style="list-style-type: decimal;">

<li>Check Directory Structure and Permissions</li></ol>



<syntaxhighlight lang="bash"># Check website root directory

sudo ls -lht /usr/share/nginx/html/

# Check target directory

sudo ls -lht /usr/share/nginx/html/folder/</syntaxhighlight>

<ol start="3" style="list-style-type: decimal;">

<li>Check Nginx Configuration</li></ol>



<syntaxhighlight lang="bash"># Check nginx config

sudo nano /etc/nginx/nginx.conf

# Or check site config

sudo nano /etc/nginx/sites-available/default</syntaxhighlight>

Basic nginx configuration should include:



<syntaxhighlight lang="nginx">server {

    listen 80;

    server_name your_domain;



    root /usr/share/nginx/html;

    index index.html;



    location / {

        try_files $uri $uri/ =404;

    }

}</syntaxhighlight>

<span id="common-issues"></span>

== Common Issues: ==



* Specific directories return 404 (files exist)

* Files uploaded via SFTP not accessible via web

* Nginx error log shows permission issues



== Solution: Adjust Permission Settings ==



# Check Nginx Error Log



<syntaxhighlight lang="bash">sudo tail /var/log/nginx/error.log</syntaxhighlight>

Possible error message:



<pre>[crit] stat() &quot;[path]/file.png&quot; failed (13: Permission denied)</pre>

<ol start="2" style="list-style-type: decimal;">

<li>Set User Directory Permissions</li></ol>



<syntaxhighlight lang="bash"># Ensure user directory is accessible

sudo chmod 755 /home/your_user</syntaxhighlight>

<ol start="3" style="list-style-type: decimal;">

<li>Set Website Directory Permissions</li></ol>



<syntaxhighlight lang="bash"># Ensure website directory is accessible

sudo chmod 755 /home/your_user/public_folder</syntaxhighlight>

<ol start="4" style="list-style-type: decimal;">

<li>(optional) Set File Permissions</li></ol>



<syntaxhighlight lang="bash"># Set file read permissions

chmod 644 /usr/share/nginx/html/folder/your_file.png</syntaxhighlight>

<span id="permission-details"></span>

== Permission Details ==



* <code>chmod 755</code> (directories):

** Owner: read, write, execute (rwx)

** Group: read and execute (r-x)

** Others: read and execute (r-x)

* <code>chmod 644</code> (files):

** Owner: read, write (rw-)

** Group: read (r–)

** Others: read (r–)



== Testing and Verification ==



<ol style="list-style-type: decimal;">

<li><p>Public URL format: <nowiki>http://your_domain/folder/file.png</nowiki></p></li>

<li><p>If still inaccessible after configuration:</p>

<syntaxhighlight lang="bash"># Reload nginx configuration

sudo systemctl reload nginx</syntaxhighlight></li></ol>



== Important Notes ==



# Permission changes take effect immediately, no nginx restart needed

# Entire path needs proper execute permissions

# New files need correct permissions set

# Ensure symbolic links remain intact

# Verify files are uploaded to correct location





[[Category: Linux]]

[[Category: Nginx]]