Troubleshooting:Service Troubleshooting - Revision history

Josh: Updated documentation from markdown files

2026-07-07T10:44:40Z

Updated documentation from markdown files

← Older revision		Revision as of 10:44, 7 July 2026
Line 1:		Line 1:
	This guide covers troubleshooting for reverse proxy services.		This guide covers troubleshooting for reverse proxy services on the VPS. Public HTTPS is handled by '''Caddy''' (<code>/etc/caddy/Caddyfile</code>).

	== Common Issues ==		== Common Issues ==
Line 16:		Line 16:
	'''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 ==		# Test VPS-local Docker service
	== (from Synology NAS or via SSH) ==		curl -sI http://127.0.0.1:PORT_NUMBER

			# Check Caddy logs
			journalctl -u caddy -n 50

			# Check if service is listening (from Synology NAS or via SSH)
	netstat -tlnp \| grep PORT_NUMBER		netstat -tlnp \| grep PORT_NUMBER
	</pre>		</pre>
Line 36:		Line 41:
	'''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

			# Validate Caddy config
			caddy validate --config /etc/caddy/Caddyfile
	</pre>		</pre>

Line 49:		Line 57:

	'''Causes''':		'''Causes''':
	* Wrong ~~proxy_pass~~ URL		* Wrong upstream URL in Caddyfile

	* Missing headers		* Missing proxy headers

	* Service requires specific path		* Service requires specific path
Line 60:		Line 68:
	* 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)		* 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~~		* Validate and reload: <code>caddy validate --config /etc/caddy/Caddyfile && systemctl reload caddy</code>

	=== Issue: Connection Timeout ===		=== Issue: Connection Timeout ===
Line 73:		Line 81:
	'''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
			cat /var/log/openvpn-status.log

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

	== 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 96:

	<pre class="lang-bash">		<pre class="lang-bash">
	~~=== Check service~~ status ~~===~~		# Caddy
	systemctl status ~~nginx~~		caddy validate --config /etc/caddy/Caddyfile
			systemctl status caddy
			systemctl reload caddy
			journalctl -u caddy -n 50

			# OpenVPN (for NAS-backed services)
			systemctl status openvpn-server@server.service
			ip addr show tun0
			cat /var/log/openvpn-status.log

	== Test ~~nginx configuration ==~~		# Test public endpoint
	~~nginx~~ -t		curl -I https://service.jb-vpn.uk

	~~== View error logs ==~~		# Docker stacks on VPS
	~~tail -f~~ /var/~~log~~/~~nginx~~/~~error.log~~		cd /var/www/wiki.jb && docker compose ps
			</pre>

	== ~~View access logs~~ ==		== Service-specific guides ==
	~~tail -f /var/log/nginx/access.log~~

	~~== Check SSL certificates ==~~		* '''Plex''': [[Troubleshooting:Plex Troubleshooting\|Troubleshooting:Plex Troubleshooting]] — auth, custom access URLs, Caddy pitfalls
	~~certbot certificates~~

	~~== Test service directly ==~~		* '''Nginx (legacy)''': [[Documentation:Nginx-Troubleshooting\|Troubleshooting:Nginx Troubleshooting]] — host/WebApp internal nginx only
	~~curl~~ -~~I https~~:/~~/service.jb-vpn.uk~~
	~~</pre>~~

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

	* [~~Adding~~ Services]~~(index.md) - Service configuration~~		* [[Services:Current Services\|Services:Current Services]] — service inventory

			* [[Documentation:Components\|System:Components]] — Caddy, VPN, Docker components

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

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

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]]