System:Service Management: Difference between revisions

Latest revision as of 14:04, 16 May 2026

This document describes how to manage edge proxy and related services on the VPS.

Caddy (public reverse proxy)

Status

systemctl status caddy

Validate configuration

caddy validate --config /etc/caddy/Caddyfile

Apply changes

systemctl reload caddy

Logs

journalctl -u caddy -f
journalctl -u caddy -n 100 --no-pager

Backup Caddyfile

cp -a /etc/caddy/Caddyfile /root/backups/caddy/Caddyfile.$(date +%F)

MediaWiki stack

cd /var/www/wiki.jb
docker compose ps
docker compose logs -f wiki
docker compose restart wiki werbs-wiki

See Documentation:Wiki Deployment.

WebApp stack

See Webapp:Deployment.

OpenVPN

systemctl status openvpn-server@server
ip addr show tun0

Maintenance checklist

Confirm Caddy is active and config validates after hostname changes

Review journalctl -u caddy after incidents

Keep Docker images updated for wiki and WebApp stacks

Verify Let's Encrypt renewal (handled by Caddy; check logs if certificates near expiry)

@@ Line 1: / Line 1: @@
-= Service Management =
+This document describes how to manage edge proxy and related services on the VPS.
-This document describes how to manage services in the reverse proxy system.
+== Caddy (public reverse proxy) ==
-== Nginx Service ==
+=== Status ===
-=== Status Check ===
 <pre class="lang-bash">
-systemctl status nginx
+systemctl status caddy
 </pre>
-=== Configuration Test ===
+=== Validate configuration ===
 <pre class="lang-bash">
-nginx -t
+caddy validate --config /etc/caddy/Caddyfile
 </pre>
-=== Reload Configuration ===
+=== Apply changes ===
-Reload nginx to apply new configuration (graceful, no downtime):
 <pre class="lang-bash">
-systemctl reload nginx
+systemctl reload caddy
 </pre>
-=== Restart Service ===
+=== Logs ===
 <pre class="lang-bash">
-systemctl restart nginx
+journalctl -u caddy -f
+journalctl -u caddy -n 100 --no-pager
 </pre>
-== Logs ==
+=== Backup Caddyfile ===
-=== Access Logs ===
+<pre class="lang-bash">
+cp -a /etc/caddy/Caddyfile /root/backups/caddy/Caddyfile.$(date +%F)
+</pre>
-'''Location''': <code>/var/log/nginx/access.log</code>
+== MediaWiki stack ==
-* Records all HTTP requests
+<pre class="lang-bash">
+cd /var/www/wiki.jb
+docker compose ps
+docker compose logs -f wiki
+docker compose restart wiki werbs-wiki
+</pre>
-* Useful for traffic analysis and debugging
+See [[Webapp:Deployment|Documentation:Wiki Deployment]].
-=== Error Logs ===
+== WebApp stack ==
-'''Location''': <code>/var/log/nginx/error.log</code>
+See [[Webapp:Deployment|Webapp:Deployment]].
-* Records errors and warnings
+== OpenVPN ==
-* First place to check for issues
-=== View Logs ===
 <pre class="lang-bash">
-tail -f /var/log/nginx/access.log
+systemctl status openvpn-server@server
-tail -f /var/log/nginx/error.log
+ip addr show tun0
 </pre>
-== Maintenance ==
+== Maintenance checklist ==
-=== Regular Tasks ===
+* Confirm Caddy is active and config validates after hostname changes
-= '''Certificate Monitoring''': Verify auto-renewal is working (certbot handles this) =
+* Review <code>journalctl -u caddy</code> after incidents
-= '''Log Review''': Check nginx logs for errors or unusual activity =
-= '''Package Updates''': Keep nginx and certbot updated =
-= '''Configuration Backups''': Backup nginx configurations periodically =
-=== Backup Commands ===
+* Keep Docker images updated for wiki and WebApp stacks
-<pre class="lang-bash">
+* Verify Let's Encrypt renewal (handled by Caddy; check logs if certificates near expiry)
-= Backup nginx configurations =
-tar -czf nginx-config-backup-$(date +%Y%m%d).tar.gz /etc/nginx/sites-available/
+== Related documentation ==
-= Backup SSL certificates (optional, usually not needed) =
+* [Network Architecture Network Architecture]
-tar -czf certbot-backup-$(date +%Y%m%d).tar.gz /etc/letsencrypt/
-</pre>
-== Related Documentation ==
+* [[Troubleshooting:Service Troubleshooting|Troubleshooting:Service Troubleshooting]]
-* [Network Architecture](network-architecture.md) - Network overview
+* [[Troubleshooting:Nginx Troubleshooting|Troubleshooting:Nginx Troubleshooting]] — legacy reference only
-* [[Documentation:Index|Troubleshooting]] - Service troubleshooting
 [[Category:Documentation]]
 [[Category:Documentation/System]]