Troubleshooting:Service 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 6:		Line 6:

	'''Causes''':		'''Causes''':
	* ~~Service~~ not running on ~~Synology~~ NAS		* Backend not running (Docker on VPS or service on NAS)

			* Caddy misconfigured or not reloaded after Caddyfile change

	* Wrong port number		* Wrong port number
Line 54:		Line 56:

	'''Solutions''':		'''Solutions''':
	* Check ~~nginx error log~~: <code>~~tail~~ -~~f /var/log/nginx/error.log~~</code>		* Check Caddy: <code>journalctl -u caddy -n 50</code>

	* Verify ~~service works~~ directly: <code>curl http://10.8.0.2:PORT</code>		* Verify backend directly: <code>curl http://127.0.0.1:PORT</code> (VPS) or <code>curl http://10.8.0.2:PORT</code> (NAS via VPN)

	* Test with different proxy_pass formats		* Test with different proxy_pass formats

Josh: Major update - troubleshooting guide: Service Troubleshooting (22 sections) (troubleshooting)

2026-01-01T13:44:46Z

Major update - troubleshooting guide: Service Troubleshooting (22 sections) (troubleshooting)

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

	This guide covers troubleshooting for reverse proxy services.		This guide covers troubleshooting for reverse proxy services.

Line 16:		Line 14:
	'''Solutions''':		'''Solutions''':
	<pre class="lang-bash">		<pre class="lang-bash">
	= Test from VPS to NAS =		==== Test from VPS to NAS ====
	ping 10.8.0.2		ping 10.8.0.2
	curl http://10.8.0.2:PORT_NUMBER		curl http://10.8.0.2:PORT_NUMBER

	= Check if service is listening =		== Check if service is listening ==
	= (from Synology NAS or via SSH) =		== (from Synology NAS or via SSH) ==
	netstat -tlnp \| grep PORT_NUMBER		netstat -tlnp \| grep PORT_NUMBER
	</pre>		</pre>
Line 36:		Line 34:
	'''Solutions''':		'''Solutions''':
	<pre class="lang-bash">		<pre class="lang-bash">
	= Check DNS =		==== Check DNS ====
	nslookup newservice.jb-vpn.uk		nslookup newservice.jb-vpn.uk

	= Verify port 80 is open =		== Verify port 80 is open ==
	curl -I http://newservice.jb-vpn.uk		curl -I http://newservice.jb-vpn.uk

	= Check firewall =		== Check firewall ==
	sudo iptables -L -n -v \| grep 80		sudo iptables -L -n -v \| grep 80
	</pre>		</pre>
Line 73:		Line 71:
	'''Solutions''':		'''Solutions''':
	<pre class="lang-bash">		<pre class="lang-bash">
	= Check VPN =		==== Check VPN ====
	ip addr show tun0		ip addr show tun0
	ping 10.8.0.2		ping 10.8.0.2

	= Check routing =		== Check routing ==
	ip route \| grep 10.8.0.2		ip route \| grep 10.8.0.2

	= Test connectivity =		== Test connectivity ==
	curl -v http://10.8.0.2:PORT_NUMBER		curl -v http://10.8.0.2:PORT_NUMBER
	</pre>		</pre>
Line 87:		Line 85:

	<pre class="lang-bash">		<pre class="lang-bash">
	= Check service status =		=== Check service status ===
	systemctl status nginx		systemctl status nginx

	= Test nginx configuration =		== Test nginx configuration ==
	nginx -t		nginx -t

	= View error logs =		== View error logs ==
	tail -f /var/log/nginx/error.log		tail -f /var/log/nginx/error.log

	= View access logs =		== View access logs ==
	tail -f /var/log/nginx/access.log		tail -f /var/log/nginx/access.log

	= Check SSL certificates =		== Check SSL certificates ==
	certbot certificates		certbot certificates

	= Test service directly =		== Test service directly ==
	curl -I https://service.jb-vpn.uk		curl -I https://service.jb-vpn.uk
	</pre>		</pre>

Josh: Minor update - troubleshooting guide: Service Troubleshooting (7 sections) (troubleshooting)

2026-01-01T13:28:24Z

Minor update - troubleshooting guide: Service Troubleshooting (7 sections) (troubleshooting)

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

	'''Causes''':		'''Causes''':
	'' Service not running on Synology NAS		* Service not running on Synology NAS
	'' Wrong port number
	'' Service not accessible via VPN		* Wrong port number

			* Service not accessible via VPN

	'''Solutions''':		'''Solutions''':
Line 26:		Line 28:

	'''Causes''':		'''Causes''':
	'' DNS not pointing to VPS		* DNS not pointing to VPS
	'' Port 80 blocked
	'' Rate limiting from Let's Encrypt		* Port 80 blocked

			* Rate limiting from Let's Encrypt

	'''Solutions''':		'''Solutions''':
Line 45:		Line 49:

	'''Causes''':		'''Causes''':
	'' Wrong proxy_pass URL		* Wrong proxy_pass URL
	'' Missing headers
	'' Service requires specific path		* Missing headers

			* Service requires specific path

	'''Solutions''':		'''Solutions''':
	'' Check nginx error log: <code>tail -f /var/log/nginx/error.log</code>		* Check nginx error log: <code>tail -f /var/log/nginx/error.log</code>
	'' Verify service works directly: <code>curl http://10.8.0.2:PORT</code>
	'' Test with different proxy_pass formats		* Verify service works directly: <code>curl http://10.8.0.2:PORT</code>

			* Test with different proxy_pass formats

	=== Issue: Connection Timeout ===		=== Issue: Connection Timeout ===

	'''Causes''':		'''Causes''':
	'' VPN tunnel down		* VPN tunnel down
	'' Service not accessible
	'' Firewall blocking		* Service not accessible

			* Firewall blocking

	'''Solutions''':		'''Solutions''':
Line 98:		Line 108:
	== Related Documentation ==		== Related Documentation ==

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

	* [System Overview](index.md) - System architecture		* [System Overview](index.md) - System architecture

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

Josh: Added troubleshooting guide: Service Troubleshooting (troubleshooting)

2026-01-01T13:16:09Z

Added troubleshooting guide: Service Troubleshooting (troubleshooting)

New page

= Service Troubleshooting =

This guide covers troubleshooting for reverse proxy services.

== Common Issues ==

=== Issue: 502 Bad Gateway ===

'''Causes''':
'' Service not running on Synology NAS
'' Wrong port number
'' Service not accessible via VPN

'''Solutions''':
<pre class="lang-bash">
= Test from VPS to NAS =
ping 10.8.0.2
curl http://10.8.0.2:PORT_NUMBER

= Check if service is listening =
= (from Synology NAS or via SSH) =
netstat -tlnp | grep PORT_NUMBER
</pre>

=== Issue: SSL Certificate Failed ===

'''Causes''':
'' DNS not pointing to VPS
'' Port 80 blocked
'' Rate limiting from Let's Encrypt

'''Solutions''':
<pre class="lang-bash">
= Check DNS =
nslookup newservice.jb-vpn.uk

= Verify port 80 is open =
curl -I http://newservice.jb-vpn.uk

= Check firewall =
sudo iptables -L -n -v | grep 80
</pre>

=== Issue: Service Not Loading ===

'''Causes''':
'' Wrong proxy_pass URL
'' Missing headers
'' Service requires specific path

'''Solutions''':
'' Check nginx error log: <code>tail -f /var/log/nginx/error.log</code>
'' Verify service works directly: <code>curl http://10.8.0.2:PORT</code>
'' Test with different proxy_pass formats

=== Issue: Connection Timeout ===

'''Causes''':
'' VPN tunnel down
'' Service not accessible
'' Firewall blocking

'''Solutions''':
<pre class="lang-bash">
= Check VPN =
ip addr show tun0
ping 10.8.0.2

= Check routing =
ip route | grep 10.8.0.2

= Test connectivity =
curl -v http://10.8.0.2:PORT_NUMBER
</pre>

== Diagnostic Commands ==

<pre class="lang-bash">
= Check service status =
systemctl status nginx

= Test nginx configuration =
nginx -t

= View error logs =
tail -f /var/log/nginx/error.log

= View access logs =
tail -f /var/log/nginx/access.log

= Check SSL certificates =
certbot certificates

= Test service directly =
curl -I https://service.jb-vpn.uk
</pre>

== Related Documentation ==

'' [Adding Services](index.md) - Service configuration
* [System Overview](index.md) - System architecture

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