System:Service Management - Revision history

Josh: Updated documentation from markdown files

2026-05-16T14:04:32Z

Updated documentation from markdown files

← Older revision		Revision as of 14:04, 16 May 2026
Line 1:		Line 1:
	This document describes how to manage services in the ~~reverse proxy system~~.		This document describes how to manage edge proxy and related services on the VPS.

	== ~~Nginx Service~~ ==		== Caddy (public reverse proxy) ==

	=== Status ~~Check~~ ===		=== Status ===

	<pre class="lang-bash">		<pre class="lang-bash">
	systemctl status ~~nginx~~		systemctl status caddy
	</pre>		</pre>

	=== ~~Configuration Test~~ ===		=== Validate configuration ===

	<pre class="lang-bash">		<pre class="lang-bash">
	~~nginx~~ -t		caddy validate --config /etc/caddy/Caddyfile
	</pre>		</pre>

	=== ~~Reload Configuration~~ ===		=== Apply changes ===

	~~Reload nginx to apply new configuration (graceful, no downtime):~~

	<pre class="lang-bash">		<pre class="lang-bash">
	systemctl reload ~~nginx~~		systemctl reload caddy
	</pre>		</pre>

	=== ~~Restart Service~~ ===		=== Logs ===

	<pre class="lang-bash">		<pre class="lang-bash">
	~~systemctl restart nginx~~		journalctl -u caddy -f
			journalctl -u caddy -n 100 --no-pager
	</pre>		</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
	* Useful for traffic analysis and debugging		docker compose ps
			docker compose logs -f wiki
			docker compose restart wiki werbs-wiki
			</pre>

	~~=== Error Logs ===~~		See [[Webapp:Deployment\|Documentation:Wiki Deployment]].

	~~'''Location''': <code>/var/log/nginx/error.log</code>~~		== WebApp stack ==

	* Records errors and warnings		See [[Webapp:Deployment\|Webapp:Deployment]].

	* First place to check for issues		== OpenVPN ==

	==~~= View Logs =~~==

	<pre class="lang-bash">		<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>		</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]]
	[[Category:Documentation/System]]		[[Category:Documentation/System]]

Josh: Content added - troubleshooting guide: Service Management (19 sections)

2026-01-01T13:44:29Z

Content added - troubleshooting guide: Service Management (19 sections)

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

	This document describes how to manage services in the reverse proxy system.		This document describes how to manage services in the reverse proxy system.

Line 60:		Line 58:
	=== Regular Tasks ===		=== Regular Tasks ===

	= '''Certificate Monitoring''': Verify auto-renewal is working (certbot handles this) =		==== '''Certificate Monitoring''': Verify auto-renewal is working (certbot handles this) ====
	= '''Log Review''': Check nginx logs for errors or unusual activity =		== '''Log Review''': Check nginx logs for errors or unusual activity ==
	= '''Package Updates''': Keep nginx and certbot updated =		== '''Package Updates''': Keep nginx and certbot updated ==
	= '''Configuration Backups''': Backup nginx configurations periodically =		== '''Configuration Backups''': Backup nginx configurations periodically ==

	=== Backup Commands ===		=== Backup Commands ===

	<pre class="lang-bash">		<pre class="lang-bash">
	= Backup nginx configurations =		==== Backup nginx configurations ====
	tar -czf nginx-config-backup-$(date +%Y%m%d).tar.gz /etc/nginx/sites-available/		tar -czf nginx-config-backup-$(date +%Y%m%d).tar.gz /etc/nginx/sites-available/

	= Backup SSL certificates (optional, usually not needed) =		== Backup SSL certificates (optional, usually not needed) ==
	tar -czf certbot-backup-$(date +%Y%m%d).tar.gz /etc/letsencrypt/		tar -czf certbot-backup-$(date +%Y%m%d).tar.gz /etc/letsencrypt/
	</pre>		</pre>

Josh: Minor update - troubleshooting guide: Service Management (13 sections)

2026-01-01T13:27:58Z

Minor update - troubleshooting guide: Service Management (13 sections)

← Older revision		Revision as of 13:27, 1 January 2026
Line 37:		Line 37:
	'''Location''': <code>/var/log/nginx/access.log</code>		'''Location''': <code>/var/log/nginx/access.log</code>

	'' Records all HTTP requests		* Records all HTTP requests
	'' Useful for traffic analysis and debugging
			* Useful for traffic analysis and debugging

	=== Error Logs ===		=== Error Logs ===
Line 44:		Line 45:
	'''Location''': <code>/var/log/nginx/error.log</code>		'''Location''': <code>/var/log/nginx/error.log</code>

	'' Records errors and warnings		* Records errors and warnings
	'' First place to check for issues
			* First place to check for issues

	=== View Logs ===		=== View Logs ===
Line 75:		Line 77:
	== Related Documentation ==		== Related Documentation ==

	'' [Network Architecture](network-architecture.md) - Network overview		* [Network Architecture](network-architecture.md) - Network overview
	'' [[Documentation:Index\|Troubleshooting]] - Service troubleshooting
			* [[Documentation:Index\|Troubleshooting]] - Service troubleshooting

	[[Category:Documentation]]		[[Category:Documentation]]
	[[Category:Documentation/System]]		[[Category:Documentation/System]]

Josh: Added troubleshooting guide: Service Management

2026-01-01T13:15:46Z

Added troubleshooting guide: Service Management

New page

= Service Management =

This document describes how to manage services in the reverse proxy system.

== Nginx Service ==

=== Status Check ===

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

=== Configuration Test ===

<pre class="lang-bash">
nginx -t
</pre>

=== Reload Configuration ===

Reload nginx to apply new configuration (graceful, no downtime):

<pre class="lang-bash">
systemctl reload nginx
</pre>

=== Restart Service ===

<pre class="lang-bash">
systemctl restart nginx
</pre>

== Logs ==

=== Access Logs ===

'''Location''': <code>/var/log/nginx/access.log</code>

'' Records all HTTP requests
'' Useful for traffic analysis and debugging

=== Error Logs ===

'''Location''': <code>/var/log/nginx/error.log</code>

'' Records errors and warnings
'' First place to check for issues

=== View Logs ===

<pre class="lang-bash">
tail -f /var/log/nginx/access.log
tail -f /var/log/nginx/error.log
</pre>

== Maintenance ==

=== Regular Tasks ===

= '''Certificate Monitoring''': Verify auto-renewal is working (certbot handles this) =
= '''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 ===

<pre class="lang-bash">
= Backup nginx configurations =
tar -czf nginx-config-backup-$(date +%Y%m%d).tar.gz /etc/nginx/sites-available/

= Backup SSL certificates (optional, usually not needed) =
tar -czf certbot-backup-$(date +%Y%m%d).tar.gz /etc/letsencrypt/
</pre>

== Related Documentation ==

'' [Network Architecture](network-architecture.md) - Network overview
'' [[Documentation:Index|Troubleshooting]] - Service troubleshooting

[[Category:Documentation]]
[[Category:Documentation/System]]