Services:Service Examples: Difference between revisions

Latest revision as of 14:04, 16 May 2026

Caddy snippets for /etc/caddy/Caddyfile. After editing, run caddy validate and systemctl reload caddy.

MediaWiki (VPS Docker)

Already configured; reference:

wiki.jb-vpn.uk {
	reverse_proxy http://127.0.0.1:8010 {
		header_up Host {host}
		header_up X-Real-IP {remote}
		header_up X-Forwarded-For {remote}
		header_up X-Forwarded-Proto {scheme}
	}
}

Web application on VPS

app.jb-vpn.uk {
	reverse_proxy 127.0.0.1:8008
}

API on VPS with path prefix

api.jb-vpn.uk {
	reverse_proxy http://127.0.0.1:3000 {
		header_up Host {host}
		header_up X-Forwarded-Proto {scheme}
	}
}

Service on NAS (HTTP)

internal.jb-vpn.uk {
	reverse_proxy http://10.8.0.2:9000 {
		header_up Host {host}
		header_up X-Forwarded-Proto {scheme}
	}
}

Plex (NAS, custom headers)

See the plex.jb-vpn.uk block in /etc/caddy/Caddyfile for the full Plex header set.

DSM (NAS, HTTPS upstream)

See the dsm.jb-vpn.uk block in /etc/caddy/Caddyfile (tls_insecure_skip_verify on the upstream transport).

Static files on VPS

vps.jb-vpn.uk {
	root * /var/www/html
	file_server
}

@@ Line 1: / Line 1: @@
-This document provides service-specific configuration examples.
+Caddy snippets for <code>/etc/caddy/Caddyfile</code>. After editing, run <code>caddy validate</code> and <code>systemctl reload caddy</code>.
-== Basic Web Application ==
+== MediaWiki (VPS Docker) ==
-<pre class="lang-nginx">
+Already configured; reference:
-server {
-    server_name app.jb-vpn.uk;
-    location / {
+<pre>
-        proxy_pass http://10.8.0.2:3000;
+wiki.jb-vpn.uk {
-        proxy_set_header Host $host;
+	reverse_proxy http://127.0.0.1:8010 {
-        proxy_set_header X-Real-IP $remote_addr;
+		header_up Host {host}
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+		header_up X-Real-IP {remote}
-        proxy_set_header X-Forwarded-Proto $scheme;
+		header_up X-Forwarded-For {remote}
-    }
+		header_up X-Forwarded-Proto {scheme}
+	}
+}
+</pre>
-    listen 80;
+== Web application on VPS ==
+<pre>
+app.jb-vpn.uk {
+	reverse_proxy 127.0.0.1:8008
 }
 </pre>
-== Service with API Path ==
+== API on VPS with path prefix ==
-If your service has a specific path prefix:
+<pre>
+api.jb-vpn.uk {
+	reverse_proxy http://127.0.0.1:3000 {
+		header_up Host {host}
+		header_up X-Forwarded-Proto {scheme}
+	}
+}
+</pre>
-<pre class="lang-nginx">
+== Service on NAS (HTTP) ==
-server {
-    server_name api.jb-vpn.uk;
-    location / {
+<pre>
-        proxy_pass http://10.8.0.2:8080/api/;
+internal.jb-vpn.uk {
-        proxy_set_header Host $host;
+	reverse_proxy http://10.8.0.2:9000 {
-        proxy_set_header X-Real-IP $remote_addr;
+		header_up Host {host}
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+		header_up X-Forwarded-Proto {scheme}
-        proxy_set_header X-Forwarded-Proto $scheme;
+	}
-    }
-    listen 80;
 }
 </pre>
-== Service Requiring Authentication Headers ==
+== Plex (NAS, custom headers) ==
+See the <code>plex.jb-vpn.uk</code> block in <code>/etc/caddy/Caddyfile</code> for the full Plex header set.
+== DSM (NAS, HTTPS upstream) ==
-<pre class="lang-nginx">
+See the <code>dsm.jb-vpn.uk</code> block in <code>/etc/caddy/Caddyfile</code> (<code>tls_insecure_skip_verify</code> on the upstream transport).
-server {
-    server_name secure.jb-vpn.uk;
-    location / {
+== Static files on VPS ==
-        proxy_pass http://10.8.0.2:9000;
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;
-        proxy_set_header Authorization $http_authorization;
-        proxy_pass_header Authorization;
-    }
-    listen 80;
+<pre>
+vps.jb-vpn.uk {
+	root * /var/www/html
+	file_server
 }
 </pre>
-== Related Documentation ==
+== Related documentation ==
+* [Step By Step Step-by-Step Process]
-* [Step-by-Step Process](step-by-step.md) - Setup process
+* [Configuration Options Configuration Options]
-* [Configuration Options](configuration-options.md) - Advanced options
 [[Category:Documentation]]
 [[Category:Documentation/Services]]
 [[Category:Documentation/Services/Adding Services]]