Files
notes/docs/home-server/mercury.md
T

6.1 KiB

schema_version, id, type, scope, sensitivity, last_reviewed, sources, related, update_triggers, unknowns
schema_version id type scope sensitivity last_reviewed sources related update_triggers unknowns
1 home-server.mercury reference
mercury
vps
hosting
nginx
wireguard
firewall
private-infrastructure 2026-10-26
kind reference
owner-report Fasthosts plan, fastfetch, nginx sites, iptables and fail2ban output, 2026-10-06
kind reference
owner-report nginx/WireGuard apt management and public IPv4/CGNAT rationale, 2026-10-06
kind reference
owner-report Uptime service confirmed as Uptime Kuma; notifications received in Discord server Jupiter, channel #uptimekuma-alerts, 2026-10-23
kind reference
owner-report Mercury uptime-kuma.sh supplied with bind mount, resource limits and log rotation, 2026-10-26
kind reference
owner-report Mercury Uptime Kuma only checks WireGuard tunnel health and whether Jupiter is online; alerts Jay on Discord when down, 2026-10-26
kind reference
owner-report Mercury monitored in Beszel; CPU above 90% for 10 minutes, memory above 90% for 10 minutes and any failed systemd services alerts configured, 2026-10-26
kind repository revision paths
repository jupiter-stacks working-tree
mercury/stacks/uptime-kuma/docker-compose.yml
mercury/stacks/uptime-kuma/README.md
home-server.reference
home-server.host
home-server.networking
home-server.operations
hosting-renewal
vps-resize
os-upgrade
proxy-change
firewall-change
certificate-change
alerting-change
renewal-price-and-renewal-date
creation-timestamp-timezone
certificate-renewal-method
wireguard-allowedips-and-keepalive
backup-and-restore-policy
uptime-kuma-exact-probes-and-alert-timing

Mercury VPS

Host / subscription

Field Configuration
Provider Fasthosts; UK data centre
Role / OS hostname Mercury / my-vps
Plan 1-1-10; KVM virtual machine
CPU 1 vCore; reported AMD EPYC-Milan @ 2.00 GHz
RAM 1 GB plan; guest reports 864.37 MiB
Disk 10 GB NVMe SSD plan; guest root ext4, 9.64 GiB
OS Debian GNU/Linux 13 (trixie); x86_64
Kernel 6.12.85+deb13-amd64
Swap Disabled
Public interface ens6; 185.230.217.66/32
WireGuard Server 10.0.0.1/24; Jupiter peer 10.0.0.2/24
Created 2026-03-01 20:48:51; timezone unconfirmed
Payment GBP 10.00 prepaid for one year; renewal terms unconfirmed

Capacities distinguish provider allocation from guest-visible values.

Ingress

nginx runs directly in the VM, not in Docker; nginx and WireGuard are apt-managed. Mercury provides static public IPv4 ingress because Jupiter's home connection uses CGNAT. Residential-IP exposure is avoided by design.

Hostname Upstream
umbra.mom, *.umbra.mom https://10.0.0.2:443 over WireGuard
gitea.umbra.mom Same; dedicated registry location /v2/
john.gatward.dev, samstoreymusic.com https://10.0.0.2:443
uptime.umbra.mom http://127.0.0.1:3001
  • HTTP -> HTTPS: 301; unmatched default server: 418.
  • TLS terminates at nginx; upstream HTTPS terminates again at Jupiter Traefik.
  • Upstream certificate verification disabled: proxy_ssl_verify off.
  • Certificates: /etc/letsencrypt/live/<domain>/{fullchain.pem,privkey.pem}; umbra.mom certificate also serves its subdomains.
  • Preserves Host; sets X-Real-IP, X-Forwarded-For, X-Forwarded-Proto; forwards WebSocket upgrade headers.
  • Gitea /v2/: unlimited request body; proxy timeouts 900s.

Monitoring / notifications

Mercury is now monitored by the Beszel hub on Jupiter, confirmed by the owner on 2026-10-26. The following Mercury alerts are configured:

Alert Trigger
CPU usage Above 90% for 10 minutes
Memory usage Above 90% for 10 minutes
Failed Services Any failed systemd service

These are deployed alert settings, not proposed additions. Beszel's Failed Services rule detects failed systemd units, not every error-level journal entry. Alert settings are stored in the Beszel hub UI/database, not the agent Compose file. Beszel cannot deliver these alerts while Jupiter or its hub is down.

Uptime Kuma runs on Mercury, served at https://uptime.umbra.mom through the local upstream http://127.0.0.1:3001. Its current monitoring scope is only the health of the WireGuard tunnel and whether Jupiter is online. It notifies Jay on Discord when either is down, using the Jupiter Discord server's #uptimekuma-alerts channel. Coverage confirmed by the owner on 2026-10-26; notification receipt previously confirmed on 2026-10-23. It does not currently monitor individual containers or application health.

The supplied ~/uptime-kuma.sh is now represented by mercury/stacks/uptime-kuma/docker-compose.yml in jupiter-stacks. It retains image louislam/uptime-kuma:2-slim, container name uptime-kuma, restart policy unless-stopped, loopback port 3001, and bind mount /opt/uptime-kuma:/app/data. Limits remain 300 MiB RAM and 0.5 CPU, with 10 MiB / 3-file log rotation (Compose explicitly selects json-file). The adjacent README documents a stopped-data backup and migration into the Mercury Portainer environment. Migration has not been confirmed; the repository change alone does not replace the running container. nginx remains host-managed.

Exact probe types, targets and alert timing have not been recorded. A failed check over WireGuard can indicate a tunnel/path failure rather than a powered-off Jupiter. Mercury monitors independently of Jupiter, but cannot report its own complete outage through this instance; an external monitor is not yet confirmed. See Observability for container-alerting guidance.

Firewall / fail2ban

  • UFW-managed iptables: INPUT/FORWARD DROP; OUTPUT ACCEPT.
  • UFW allows TCP 22,80,443; UDP 80,443,51820.
  • Docker forwarding has separate rules; INPUT policy alone does not define container exposure.
  • Fail2ban jails: nginx-botsearch, nginx-http-auth, sshd.

Rules and versions are supplied snapshots, not live inspection.