router-troubleshooting

Diagnose and recover M5 router startup failures by cleaning INI entries and terminating rogue processes.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/crycriM/hermes-skills --skill router-troubleshooting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: router-troubleshooting
Source: https://github.com/crycriM/hermes-skills/tree/main/router-troubleshooting
Command: npx skills add https://github.com/crycriM/hermes-skills --skill router-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Fix m5-router.service issues - orphaned INI entries, rogue llama-server processes blocking port 8080. The skill provides a deterministic recovery sequence to restore service availability and GUI operation.

Core Features & Use Cases

  • Diagnose and resolve router startup failures, clean orphaned INI entries, and terminate rogue llama-server processes that block port 8080.
  • Validate router configuration and ensure port 8088 is used for the GUI after recovery.
  • Use case: When the GUI shows no models or the router cannot bind on port 8080, run the recovery workflow to restore normal operation and model visibility.

Quick Start

Diagnose and recover a malfunctioning router by stopping services, cleaning problematic INI entries, terminating rogue llama-server processes, and restarting the m5-router service.

Frequently Asked Questions about router-troubleshooting

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

FAQPage Schema
How do I fix a router service startup failure when port 8080 is blocked?

To fix a router service startup failure when port 8080 is blocked, you need to stop the m5-router service, terminate rogue llama-server processes occupying the port, and restart the service to restore availability.

Why does my router GUI show no models after a restart?

Your router GUI shows no models because orphaned INI entries and rogue processes disrupt the configuration. Cleaning these problematic INI entries and restarting the router service restores normal GUI operation and model visibility.

What is the best way to clean orphaned INI entries in an m5-router deployment?

The best way to clean orphaned INI entries in an m5-router deployment is to run a deterministic recovery workflow that stops services, removes the invalid configuration data, and verifies the service status before restarting.

How do I terminate rogue llama-server processes blocking port 8080?

To terminate rogue llama-server processes blocking port 8080, execute a process-management sequence to stop the services, kill the conflicting processes, and verify the port bindings are cleared before restarting the router.

Does router troubleshooting require verifying port 8088 for GUI operation?

Yes, router troubleshooting requires verifying port 8088 for GUI operation. After cleaning INI entries and terminating rogue processes, you must validate the router configuration to ensure port 8088 is correctly used for the GUI.

Can I use this router recovery workflow for any systemd service failure?

No, this router recovery workflow is specifically designed for m5-router deployments experiencing startup failures, missing GUI models, or port 8080 conflicts, rather than general systemd service failures.