control

Control running Synchronet BBS instances across Linux, BSD, macOS, and Windows.

107|19|Updated Sep 4, 2020
One-click install
npx skills add https://github.com/SynchronetBBS/sbbs --skill control-synchronetbbs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: control
Source: https://github.com/SynchronetBBS/sbbs/tree/main/.claude/skills/control
Command: npx skills add https://github.com/SynchronetBBS/sbbs --skill control-synchronetbbs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the guesswork and risk of data loss or unnecessary downtime when managing a running Synchronet BBS instance, providing clear guidance on the correct control method for every common and edge-case operation.

Core Features & Use Cases

  • Cross-platform lifecycle control: Manage server recycling, graceful shutdown, pausing new connections, clearing failed-login lists, and forcing timed events on Linux, BSD, macOS, and Windows hosts.
  • Granular scoping: Target operations to specific servers, specific hosts, or all instances, with built-in safeguards for shared ctrl/ storage setups to avoid misfires across multiple hosts.
  • Safety and troubleshooting: Includes guardrails to avoid common pitfalls like accidental full process restarts, stuck recycles, and unintended config-triggered recycles, plus guidance for Windows service managers, POSIX signals, and MQTT control planes.
  • Use Case: A sysop needs to reload only the web server configuration without disrupting active terminal user sessions can use a targeted semaphore file instead of a full process restart that would drop all connections.

Quick Start

Use the control skill to recycle only the web server on the current host without affecting other running services or active user sessions.

Frequently Asked Questions about control

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

FAQPage Schema
How do I restart a single Synchronet BBS server without dropping active user sessions?

Use a targeted semaphore file to recycle only the specific Synchronet server process instead of triggering a full process restart, which avoids dropping active terminal or web user sessions.

Does Synchronet BBS server control work across Linux, BSD, macOS, and Windows?

Yes, Synchronet BBS server control works across Linux, BSD, macOS, and Windows by leveraging cross-platform semaphore files, POSIX signals, OS service managers, and Windows front-ends for lifecycle management.

What is the best way to pause new connections on a running Synchronet BBS instance?

The best way to pause new connections on a running Synchronet BBS instance is to use the provided control skill mechanisms, which safely stops inbound logins without terminating existing active sessions.

How do I force a timed event or clear failed-login lists in Synchronet BBS?

You force a timed event or clear failed-login lists in Synchronet BBS by issuing specific semaphore files or MQTT control plane commands to trigger the action immediately without waiting for the scheduled interval.

Why do Synchronet BBS config changes accidentally trigger a full process restart on shared storage?

Synchronet BBS config changes might trigger a full process restart on shared storage if scoping is not properly configured, causing misfires across multiple hosts reading from the same shared ctrl/ directory.

When should I use POSIX signals vs MQTT control planes for Synchronet BBS lifecycle management?

Use POSIX signals for direct host-level process management, whereas MQTT control planes are better for remote, granular server lifecycle operations across distributed Synchronet BBS instances with active safety guardrails.