hermes-restart

Restart a Hermes gateway on a remote VPS via SSH and clear stale PID and lock files.

13|1|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/paarths-collab/hstack --skill hermes-restart
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermes-restart
Source: https://github.com/paarths-collab/hstack/tree/main/skills/hermes-restart
Command: npx skills add https://github.com/paarths-collab/hstack --skill hermes-restart

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill fixes stalled or broken Hermes gateway restarts on a remote VPS by clearing stale PID and lock files, then bringing the service back up cleanly and verifying it is healthy.

Core Features & Use Cases

  • Safe Gateway Recovery: Stops the gateway gracefully, sweeps stale lock files, and restarts with a clean process state.
  • SSH-First Maintenance: Works entirely over SSH on the remote host, with checks for host-versus-container environments.
  • Health Verification and Persistence: Confirms the gateway is running, checks logs and health endpoints, and can optionally reinstall autostart for reboot survival.
  • Use Case: A Hermes deployment gets stuck in a restart loop after a crash or OOM event; this Skill clears the stale state and returns the gateway to service without manual debugging.

Quick Start

Ask the AI to cleanly restart the Hermes gateway on your VPS, clear stale PID and lock files, and verify that the service is healthy afterward.

Frequently Asked Questions about hermes-restart

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I restart a Hermes gateway stuck in a restart loop after a crash?

To restart a Hermes gateway stuck in a restart loop, you need to clear stale PID and lock files over SSH before bringing the service back up. This gracefully stops the gateway, sweeps the blocking files, and restarts with a clean process state to restore service.

How do I clear stale PID and lock files on a VPS to recover a crashed Hermes gateway?

Clearing stale PID and lock files on a VPS involves stopping the Hermes gateway gracefully via SSH and sweeping the residual state files that block recovery. This ensures a clean process state before the gateway restarts and verifies service health.

Does Hermes gateway recovery work for both host and container deployments over SSH?

Yes, Hermes gateway recovery over SSH works for both host and container deployments. The maintenance process detects the environment and applies the appropriate restart logic, clearing stale files and verifying health across either setup.

Why does my Hermes gateway fail to recover after an OOM event on my remote server?

A Hermes gateway often fails to recover after an OOM event because stale PID and lock files prevent a clean process restart. Removing these residual files over SSH allows the gateway to initialize properly and pass health verification checks.

Can I use systemd to autostart a Hermes gateway after clearing stale lock files?

Yes, you can use systemd to autostart a Hermes gateway after clearing stale lock files. The recovery process verifies service health and can optionally reinstall autostart persistence for reboot survival, with a tmux fallback available if needed.