Canadian Gator Command Library

One place for your helper scripts and admin shortcuts on the VPS — from gatorhealth to Minecraft helpers and future security tooling.

Live core commands: gatorhealth, gatorjail, gatorstatus, gatorcraft-start
🛠️ Planned: backups, security hardening helpers, log bundles
🔎
Filter:

Core status & overview

Quick “what’s going on?” checks
$sudo gatorhealth
Live

Full “at a glance” VPS health report: uptime, load, memory, disk usage, top memory hogs, Docker container states, UFW rules, and last syslog errors.

core status sysadmin
runs in ~1 sec
Use via SSH (sudo)
$sudo gatorstatus
Live

Machine-readable status helper feeding the dev site: summarizes jail bans, containers, and key metrics into structured JSON for dashboards.

core json monitoring
pairs with dev.canadiangator.net
root / sudo recommended
$gatorlogs
Draft idea

Planned helper to bundle “useful when things are weird” logs (Caddy, Docker, mail, Fail2Ban) into one view or export.

logs maintenance troubleshooting
not implemented yet
use as future script name

Security & bans

Fail2Ban, access, and planned hardening
$sudo gatorjail
Live

Friendly wrapper around fail2ban-client showing all jails, current bans, and recidive offenders in a clean, Gator-style summary.

security fail2ban ssh/mail
read-only status
sudo required
$gatordefense
Planned

Future hardening helper: check SSH ports, 2FA status, UFW rules, Fail2Ban coverage, and suggest next security upgrades in plain English.

security 2FA audit
design phase only
for future script

Minecraft helpers

Commands related to the GatorCraft server
$gatorcraft-start
Live

Helper to start (or restart) the main Minecraft Docker container with the correct JVM flags and memory settings (Aikar-style tuning).

minecraft server docker
wraps docker commands
run as your admin user
$gatorcraft-stop
Planned

Future “friendly shutdown” for the Minecraft server — announce, save, then stop the container cleanly to avoid world corruption.

minecraft maintenance
script idea only
for future helper

Maintenance & backups

Future helpers around updates and safety nets
$gatorbackup
Planned

Planned wrapper around your existing rclone job to run a one-off backup, check the log, and confirm success in a human-readable summary.

maintenance backups rclone
ties into existing cron job
future helper
$gatorservices
Draft idea

Concept: one place to confirm key systemd services (postfix, dovecot, docker, fail2ban, etc.) are active and enabled, with a tiny summary.

maintenance systemd
naming reserved
future helper

Mail & monitoring (future)

Ideas for your postfix + dovecot stack
$gator-mailcheck
Planned

Future UX-friendly mail check: service status, mail queue count, last authentication errors, and TLS certificate info all in one place.

mail postfix dovecot
design only
future helper
🧩 Tip: When you actually implement one of the “draft/planned” commands, update this page first so your future self always has a single source of truth.
🔗 Linked: Dev Hub tile → commandlib.canadiangator.net · Gator Peeb’s Apothecary → peebsapothecary.canadiangator.net
✅ Command copied to clipboard