Jump to content

Services:Prerequisites: Difference between revisions

From jb-vpn.uk Wiki
Added troubleshooting guide: Prerequisites for Adding Services
 
Minor update - troubleshooting guide: Prerequisites for Adding Services (7 sections)
Line 65: Line 65:
== Related Documentation ==
== Related Documentation ==


'' [Step-by-Step Process](step-by-step.md) - Next steps after prerequisites
* [Step-by-Step Process](step-by-step.md) - Next steps after prerequisites
'' [System Overview](index.md) - System architecture
 
* [System Overview](index.md) - System architecture


[[Category:Documentation]]
[[Category:Documentation]]
[[Category:Documentation/Services]]
[[Category:Documentation/Services]]
[[Category:Documentation/Services/Adding Services]]
[[Category:Documentation/Services/Adding Services]]

Revision as of 13:28, 1 January 2026

Prerequisites for Adding Services

Before adding a new service to the reverse proxy system, ensure you have the following:

Service Information

Subdomain name (e.g., newservice.jb-vpn.uk)

Internal IP address (usually 10.8.0.2 for Synology NAS)

Internal port number (e.g., 8080, 3000, etc.)

Protocol (HTTP or HTTPS)

DNS Configuration

DNS A record created pointing subdomain to VPS IP (87.106.61.62)

DNS propagation completed (can take up to 48 hours, usually much faster)

Verify DNS Configuration

= Check DNS resolution =
nslookup newservice.jb-vpn.uk

= Or using dig =
dig newservice.jb-vpn.uk +short

Service Verification

Before configuring the reverse proxy, verify:

Service is running on Synology NAS

Service is accessible from VPN network

Test from VPS: curl http://10.8.0.2:[PORT] ### Test Service Accessibility

= Test service from VPS =
curl http://10.8.0.2:8080

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

System Requirements

Ensure the following are in place:

OpenVPN tunnel is active (tun0 interface up)

Synology NAS is connected to VPN (10.8.0.2 reachable)

Nginx is running on the VPS

Port 80 is accessible (required for SSL certificate validation)

Verify System Status

= Check VPN connectivity =
ping 10.8.0.2

= Check nginx status =
systemctl status nginx

= Check VPN interface =
ip addr show tun0
  • [Step-by-Step Process](step-by-step.md) - Next steps after prerequisites
  • [System Overview](index.md) - System architecture