Troubleshooting:Nginx Troubleshooting - Revision history

Josh: Updated documentation from markdown files

2026-05-16T14:04:34Z

Updated documentation from markdown files

← Older revision		Revision as of 14:04, 16 May 2026
Line 1:		Line 1:
	This guide covers ~~troubleshooting for~~ Nginx ~~configuration~~ and ~~service issues~~.		'''Note:''' Public HTTPS on this VPS is handled by '''Caddy''' (<code>/etc/caddy/Caddyfile</code>). Use [[System:Service Management]] and <code>journalctl -u caddy</code> for edge proxy issues.

			This guide covers '''legacy host Nginx''' site files and the '''WebApp stack's internal Nginx''' container. Host Nginx is not the active edge proxy for <code>*.jb-vpn.uk</code> services.

	== Configuration Errors ==		== Configuration Errors ==

Josh: Major update - troubleshooting guide: Nginx Troubleshooting (23 sections) (troubleshooting)

2026-01-01T13:44:44Z

Major update - troubleshooting guide: Nginx Troubleshooting (23 sections) (troubleshooting)

← Older revision		Revision as of 13:44, 1 January 2026
Line 1:		Line 1:
	~~= Nginx Troubleshooting =~~

	This guide covers troubleshooting for Nginx configuration and service issues.		This guide covers troubleshooting for Nginx configuration and service issues.

Line 31:		Line 29:
	=== Nginx Won't Start ===		=== Nginx Won't Start ===

	= '''Check status''': =		==== '''Check status''': ====
	<pre class="lang-bash">		<pre class="lang-bash">
	systemctl status nginx		systemctl status nginx
	</pre>		</pre>

	= '''Check logs''': =		== '''Check logs''': ==
	<pre class="lang-bash">		<pre class="lang-bash">
	journalctl -u nginx -n 50		journalctl -u nginx -n 50
	</pre>		</pre>

	= '''Test configuration''': =		== '''Test configuration''': ==
	<pre class="lang-bash">		<pre class="lang-bash">
	nginx -t		nginx -t
Line 48:		Line 46:
	=== Nginx Reload Fails ===		=== Nginx Reload Fails ===

	= '''Test configuration first''': =		==== '''Test configuration first''': ====
	<pre class="lang-bash">		<pre class="lang-bash">
	nginx -t		nginx -t
	</pre>		</pre>

	= '''Check for syntax errors''' in configuration files =		== '''Check for syntax errors''' in configuration files ==

	= '''Verify file permissions''': =		== '''Verify file permissions''': ==
	<pre class="lang-bash">		<pre class="lang-bash">
	ls -la /etc/nginx/sites-enabled/		ls -la /etc/nginx/sites-enabled/
Line 65:		Line 63:

	<pre class="lang-bash">		<pre class="lang-bash">
	= View recent errors =		==== View recent errors ====
	tail -f /var/log/nginx/error.log		tail -f /var/log/nginx/error.log

	= Search for specific errors =		== Search for specific errors ==
	grep "error" /var/log/nginx/error.log		grep "error" /var/log/nginx/error.log
	</pre>		</pre>
Line 75:		Line 73:

	<pre class="lang-bash">		<pre class="lang-bash">
	= View recent access =		==== View recent access ====
	tail -f /var/log/nginx/access.log		tail -f /var/log/nginx/access.log

	= Analyze traffic =		== Analyze traffic ==
	awk '{print $1}' /var/log/nginx/access.log \| sort \| uniq -c \| sort -rn		awk '{print $1}' /var/log/nginx/access.log \| sort \| uniq -c \| sort -rn
	</pre>		</pre>

Josh: Minor update - troubleshooting guide: Nginx Troubleshooting (13 sections) (troubleshooting)

2026-01-01T13:28:22Z

Minor update - troubleshooting guide: Nginx Troubleshooting (13 sections) (troubleshooting)

← Older revision		Revision as of 13:28, 1 January 2026
Line 10:		Line 10:

	'''Solutions''':		'''Solutions''':
	'' Check for missing semicolons		* Check for missing semicolons
	'' Verify bracket matching
	'' Check for typos in directive names		* Verify bracket matching

			* Check for typos in directive names

	=== Duplicate Server Names ===		=== Duplicate Server Names ===
Line 19:		Line 21:

	'''Solutions''':		'''Solutions''':
	'' Check all configuration files in <code>/etc/nginx/sites-enabled/</code>		* Check all configuration files in <code>/etc/nginx/sites-enabled/</code>
	'' Remove duplicate server_name entries
	'' Ensure only one config per subdomain		* Remove duplicate server_name entries

			* Ensure only one config per subdomain

	== Service Issues ==		== Service Issues ==
Line 82:		Line 86:
	=== SSL Certificate Problems ===		=== SSL Certificate Problems ===

	'' Verify certificate exists: <code>certbot certificates</code>		* Verify certificate exists: <code>certbot certificates</code>
	'' Check certificate expiration: <code>openssl x509 -in /etc/letsencrypt/live/domain/cert.pem -noout -dates</code>
	'' Renew if needed: <code>certbot renew</code>		* Check certificate expiration: <code>openssl x509 -in /etc/letsencrypt/live/domain/cert.pem -noout -dates</code>

			* Renew if needed: <code>certbot renew</code>

	=== Proxy Issues ===		=== Proxy Issues ===

	'' Check proxy_pass URL is correct		* Check proxy_pass URL is correct
	'' Verify target service is accessible
	'' Check proxy headers are set correctly		* Verify target service is accessible

			* Check proxy headers are set correctly

	== Related Documentation ==		== Related Documentation ==

	'' [Adding Services](index.md) - Service configuration		* [Adding Services](index.md) - Service configuration
	'' [Service Management](service-management.md) - Service management
			* [Service Management](service-management.md) - Service management

	[[Category:Documentation]]		[[Category:Documentation]]
	[[Category:Documentation/Troubleshooting]]		[[Category:Documentation/Troubleshooting]]

Josh: Added troubleshooting guide: Nginx Troubleshooting (troubleshooting)

2026-01-01T13:16:08Z

Added troubleshooting guide: Nginx Troubleshooting (troubleshooting)

New page

= Nginx Troubleshooting =

This guide covers troubleshooting for Nginx configuration and service issues.

== Configuration Errors ==

=== Syntax Errors ===

'''Symptoms''': <code>nginx -t</code> fails with syntax errors

'''Solutions''':
'' Check for missing semicolons
'' Verify bracket matching
'' Check for typos in directive names

=== Duplicate Server Names ===

'''Symptoms''': Warning about duplicate server_name

'''Solutions''':
'' Check all configuration files in <code>/etc/nginx/sites-enabled/</code>
'' Remove duplicate server_name entries
'' Ensure only one config per subdomain

== Service Issues ==

=== Nginx Won't Start ===

= '''Check status''': =
<pre class="lang-bash">
systemctl status nginx
</pre>

= '''Check logs''': =
<pre class="lang-bash">
journalctl -u nginx -n 50
</pre>

= '''Test configuration''': =
<pre class="lang-bash">
nginx -t
</pre>

=== Nginx Reload Fails ===

= '''Test configuration first''': =
<pre class="lang-bash">
nginx -t
</pre>

= '''Check for syntax errors''' in configuration files =

= '''Verify file permissions''': =
<pre class="lang-bash">
ls -la /etc/nginx/sites-enabled/
</pre>

== Log Analysis ==

=== Error Logs ===

<pre class="lang-bash">
= View recent errors =
tail -f /var/log/nginx/error.log

= Search for specific errors =
grep "error" /var/log/nginx/error.log
</pre>

=== Access Logs ===

<pre class="lang-bash">
= View recent access =
tail -f /var/log/nginx/access.log

= Analyze traffic =
awk '{print $1}' /var/log/nginx/access.log | sort | uniq -c | sort -rn
</pre>

== Common Configuration Issues ==

=== SSL Certificate Problems ===

'' Verify certificate exists: <code>certbot certificates</code>
'' Check certificate expiration: <code>openssl x509 -in /etc/letsencrypt/live/domain/cert.pem -noout -dates</code>
'' Renew if needed: <code>certbot renew</code>

=== Proxy Issues ===

'' Check proxy_pass URL is correct
'' Verify target service is accessible
'' Check proxy headers are set correctly

== Related Documentation ==

'' [Adding Services](index.md) - Service configuration
'' [Service Management](service-management.md) - Service management

[[Category:Documentation]]
[[Category:Documentation/Troubleshooting]]