KSP — Kush Secure Protocol

Core & Lifecycle

RFC § 7.2 — Server Handshake State Machine

Purpose

Start a full-featured KSP protocol server instance with real-time stream multiplexing and logging.

Syntax

Command-line specification

bash / powershell

ksp server [SUBCOMMAND | OPTIONS]

Arguments

Argument	Description
[SUBCOMMAND]	Optional action: `start`, `stop`, `restart`, or `status` (defaults to `start`).

Options & Flags

Option Flag	Description
--port <PORT>	TCP/UDP port number to bind for KSP connections (default: `9876`).
--bind <ADDR>	Interface IP address to bind (default: `0.0.0.0`).
--cert <PATH>	Path to Ed25519 public certificate file (`server.cert`).
--key <PATH>	Path to Ed25519 private key file (`server.key`).
--max-streams <NUM>	Maximum concurrent open streams allowed per session (default: `256`).

Example Usage

Example command

ksp server --bind 127.0.0.1 --port 9876 --max-streams 512

Expected Output

════════════════════════════════════════════════════════════
══              KSP Protocol Server v0.1.0                ══
════════════════════════════════════════════════════════════
  [+] Listening Address:  127.0.0.1:9876
  [+] Cipher Suite:       AES-256-GCM / ChaCha20-Poly1305 (Auto-Negotiate)
  [+] Session Timeout:    3600 seconds
  [+] Max Streams/Sess:   512
  [✔] Server initialized and ready for handshakes.

Implementation Notes

The flagship reference implementation of the KSP server specification. Supports graceful reload and immediate GoAway broadcast on SIGINT.

Related CommandsView All 50 Commands →

ksp connect

ksp monitor

ksp dashboard

CLI Installation Guide· Quick Start Workflow· GitHub Source Repository