Skip to content

kexsh server

The kexsh server is a background daemon that manages all terminal instances. It starts automatically when you create a terminal, but you can also manage it directly.

Terminal window
kexsh server <command>

Start the server as a background daemon.

Terminal window
kexsh server start
Server started (pid: 12345)

The server forks into the background — you can close the terminal that started it. If the server is already running, this is a no-op.

Stop the server. All running terminals are terminated.

Terminal window
kexsh server stop
Server stopped

Check whether the server is running.

Terminal window
kexsh server status
Server running (pid: 12345)
Terminals: 3
Uptime: 2 hours

The server communicates with the CLI client over a Unix domain socket. When you run commands like kexsh terminal create, the CLI sends a request to the server over IPC, and the server manages the actual terminal process.

The PID file is stored at $XDG_RUNTIME_DIR/kexsh/server.pid (or /tmp/kexsh-<uid>/server.pid as fallback).