The Problem

You're on a walk. Your phone buzzes — a service needs a restart. With any other setup, you'd need a laptop, a terminal, and an SSH session. The walk is over.

The Solution

With gotify-commander, you tap restart nginx and get ✅ nginx restarted. Same app you already use for alerts — now it talks back. No laptop, no SSH, no terminal. Walk continues.

▮▮

Commands & service management from your phone

▶

GPS location with reverse geocoding

Features

💻

23 Commands, 6 Categories

Restart services, check disk, view logs, analyze traffic, locate your phone — all from the Gotify app you already use.

🌐

Web Control Panel

A browser dashboard built with Pico CSS. Live service status grid, one-click restart/stop/start, command history, system metrics — all driven by your YAML config.

🔄

Unified App Architecture

Commands and responses flow through a single Gotify app. Send a command, get the reply as the next notification. No separate channels to manage.

🖥

Multi-Machine

VPS services via systemctl, Mac Mini services via SSH + launchctl. Target any machine by name — free mac, uptime vps.

🔒

Security-First

Tailscale VPN + Gotify login + random plugin token. Command whitelist only — no shell passthrough, no injection, configurable timeouts. Reboot requires explicit target.

📍

GPS Locate & Analytics

Locate your devices with locate. Analyze traffic with rhit, web analytics with GoAccess. TLS cert checks, DNS lookups, HTTP health probes.

⚙

Dynamic YAML Config

Add a service to YAML — it appears in commands, web UI, and status reports automatically. Categories, domains, ports, aliases, favicons — all config-driven.

⭐

First Bidirectional Plugin

Every existing Gotify plugin is one-way — forward to Telegram, Slack, or email. gotify-commander closes the loop: type a command, get the result back.

Architecture

gotify-commander loads as a native Gotify plugin (.so). It intercepts messages on a unified command app, executes the matching whitelisted command, and sends the result back as a notification on the same app.

# Data flow

📱 Phone  →  Gotify Client  →  Gotify Server  →  gotify-commander (.so)
                                                       ↓
                                              systemctl / SSH+launchctl  →  Target Machine
                                                       ↓
                                              Result notification  →  📱 Phone

# Web UI
💻 Browser  →  https://gotify.example.com/plugin/gotify-commander/  →  Control Panel

The plugin runs inside the Gotify server process — no separate daemon, no extra ports, no external dependencies. Commands dispatch to local systemctl, remote SSH/launchctl, or diagnostic tools as configured in YAML. The web UI is served at the plugin's webhook path.

Quick Start

Download the plugin binary, drop it into Gotify's plugin directory, and restart. Under two minutes.

# 1. Download the plugin for your architecture
wget https://github.com/drolosoft/gotify-commander/releases/latest/download/gotify-commander-linux-amd64.so

# 2. Copy to Gotify's plugin directory
cp gotify-commander-linux-amd64.so /opt/gotify/data/plugins/

# 3. Restart Gotify
systemctl restart gotify

# 4. Configure via Gotify WebUI
# Plugins → gotify-commander → Configuration → Paste your YAML

# 5. Send your first command
# From the Gotify app on your phone, type:
help

Command Reference

23 commands organized across 5 categories. All accept aliases and machine targets.

🔄 Service Management (7)

Command	Args	Description
`status`	`[service]`	Status of all services, or a specific one
`restart`	`<service>`	Restart a service (supports aliases)
`start`	`<service>`	Start a service
`stop`	`<service>`	Stop a service
`logs`	`<service>`	Tail the last N lines of service logs
`services`	—	List all managed services
`help`	—	Show all commands and configured services

📊 System Diagnostics (9)

Command	Args	Description
`free`	`[vps\|mac]`	Memory usage
`df`	`[vps\|mac]`	Disk usage
`uptime`	`[vps\|mac]`	System uptime + load average
`top`	`[vps\|mac]`	Top processes by CPU/memory
`who`	`[vps\|mac]`	Currently logged-in users
`ping`	`[vps\|mac]`	Health check — responds with "pong" + latency
`ip`	`[vps\|mac]`	IP addresses
`ports`	`[vps\|mac]`	Open listening ports
`connections`	`[vps\|mac]`	Socket statistics

🌐 Monitoring & Analytics (4)

Command	Args	Description
`traffic`	`[service]`	Nginx traffic analysis via rhit
`analytics`	—	Web analytics summary via GoAccess
`certs`	—	SSL certificate expiry for all domains
`updates`	—	Pending system updates (apt)

📍 Location (1)

Command	Args	Description
`locate`	`<lat> <lon>`	GPS reverse geocoding via OpenStreetMap

⚠ Danger (2)

Command	Args	Description
`reboot`	`<vps\|mac>`	Reboot a machine (requires explicit target)
`shutdown`	`<vps\|mac>`	Shutdown a machine (requires explicit target)

Universal aliases: mem/memory → free · disk/space → df · log → logs · up → uptime. Typing just a service name is treated as status <service>.

Why Gotify Commander?

Every other Gotify plugin forwards notifications somewhere else. This one lets you act on them.

	gotify-commander	Telegram Bot	Uptime Kuma
Self-hosted	✅	❌	✅
Bidirectional	✅	✅	❌
Runs inside Gotify	✅	❌	❌
No third-party services	✅	❌	✅
Service management	✅	varies	❌
Multi-machine (SSH)	✅	varies	❌
Web control panel	✅	❌	✅
Traffic & analytics	✅	❌	❌
GPS locate	✅	❌	❌
Tailscale security	✅	❌	❌
Phone app already installed	✅	✅	❌

Web Control Panel

A browser dashboard built with Pico CSS that lives at https://your-domain/plugin/gotify-commander/.

Live service status grid — all services grouped by category, color-coded ✅ / ❌
One-click restart / start / stop for any service
Command history with timestamps and results
System metrics (memory, disk, uptime) at a glance
Dynamic favicons fetched from service domains
Dynamic categories from your YAML config — no hardcoding

Access is secured through your existing Gotify login. No extra credentials.

Configuration

All configuration lives in a single YAML file, editable through the Gotify WebUI. Define your services, categories, machines, domains, and aliases. Add a service — it appears everywhere.

# Example YAML configuration
gotify:
  server_url: "http://localhost:2006"
  base_url: "https://gotify.example.com"
  client_token: "your-client-token"
  command_app_id: 1
  response_app_token: "your-token"

categories:
  web:
    label: "🌐 Web"
    type: web
  media:
    label: "📺 Media"
    type: media
  monitoring:
    label: "📊 Monitoring"
    type: monitoring

services:
  nginx:
    description: "🌐 Web Server"
    category: web
    domain: "example.com"
    machine: vps
    port: 80
    aliases: [ng, web]
    systemd: nginx

  homeserver:
    description: "🏠 Home Server"
    category: media
    machine: mac
    port: 8080
    aliases: [home]
    launchd: com.myapp.service

ssh_targets:
  mac:
    host: "100.x.x.x"       # Tailscale IP recommended
    port: 22
    user: "admin"
    key_file: "/home/admin/.ssh/id_rsa"

Security

Tailscale VPN — all SSH and HTTP traffic encrypted peer-to-peer, never exposed to the public internet
Gotify login — web UI is gated behind your existing Gotify authentication
Command whitelist — only registered commands execute; no arbitrary command execution
Input sanitization — most commands use exec.Command; the few requiring a shell validate all input with strict regex
Input sanitization — service names must match ^[a-zA-Z0-9_-]+$
Execution timeouts — configurable (default 30s), prevents runaway processes
SSH key-only auth — password auth not supported
Reboot requires explicit target — reboot alone returns an error, preventing accidental reboots
Audit trail — every command logged: timestamp, command, source, result, duration

Platform Compatibility

gotify-commander runs wherever Gotify runs. The plugin binary is compiled for each target architecture.

Platform	Architecture
Linux	amd64
Linux	arm64
Linux	arm/v7

Built With

A single Go plugin (.so) with no runtime dependencies beyond Gotify itself.

Go Plugin (.so) — Loads natively inside Gotify server
Gotify Plugin API — First-class integration, no hacks
SSH — Remote machine management via standard SSH
YAML Config — Human-readable, WebUI-editable
Pico CSS — Minimal, semantic web UI with zero JS frameworks
Gin — Lightweight HTTP router for the control panel

Star on GitHub

I build tools I wish existed, then give them away.
If one of them saved you time, a coffee keeps the next one coming.

The Problem

The Solution

Features

23 Commands, 6 Categories

Web Control Panel

Unified App Architecture

Multi-Machine

Security-First

GPS Locate &amp; Analytics

Dynamic YAML Config

First Bidirectional Plugin

Architecture

Quick Start

Command Reference

🔄 Service Management (7)

📊 System Diagnostics (9)

🌐 Monitoring & Analytics (4)

📍 Location (1)

⚠ Danger (2)

Why Gotify Commander?

Web Control Panel

Configuration

Security

Platform Compatibility

Built With

Ready to manage your servers from your phone?

GPS Locate & Analytics