Local & Cluster
krishiv local / cluster — managing single-node and bare-metal deployments.
Two lifecycle commands for managing a self-hosted Krishiv process tree. Both use a JSON file under .krishiv/ to track PIDs and config.
krishiv local
Spawns a coordinator, a Flight SQL sidecar, and an executor on one machine. UI on http://<http-addr>/ui.
krishiv local start
krishiv local status
krishiv local stop
krishiv local restart
Env vars: KRISHIV_LOCAL_DATA_DIR (default .krishiv/local), KRISHIV_LOCAL_HTTP_ADDR (default 127.0.0.1:2002).
Persists <data_dir>/cluster.json with the assigned ports and PIDs.
krishiv cluster
Bare-metal cluster control plane + N executors. clusterd listens on 127.0.0.1:2001 (gRPC) and 127.0.0.1:2002 (HTTP / UI). Executors bind to (2005 + 2i, 2006 + 2i) so adjacent executors never collide.
krishiv cluster start --executors 4
krishiv cluster status
krishiv cluster verify-network
krishiv cluster stop
Flags: --data-dir <DIR>, --executors <N> (default 2), --http-addr <HOST:PORT>. Env: KRISHIV_CLUSTER_DATA_DIR (default .krishiv/cluster), KRISHIV_CLUSTER_HTTP_ADDR (default 127.0.0.1:2002).
Daemon subcommands
For finer control, run the daemons directly. Each is the long-running process that local and cluster manage.
| Daemon | What it is |
|---|---|
krishiv coordinator | Active coordinator. gRPC + HTTP + optional UI + optional Flight SQL sidecar. |
krishiv clusterd | Cluster control plane — coordinator + leader election + UI + optional Flight SQL. |
krishiv job-coordinator | Per-job coordinator for very-large-job sharding. Multiple instances can run for one job. |
krishiv executor | Data-plane worker. Connects to the coordinator gRPC and pulls task assignments. |
krishiv flight-server | Standalone Arrow Flight SQL server. Env: KRISHIV_FLIGHT_ADDR (default 127.0.0.1:2003). |
krishiv shuffle-svc | External shuffle service. Env: KRISHIV_SHUFFLE_ADDR (default 0.0.0.0:2004), KRISHIV_SHUFFLE_DIR. |
If you build with the flight-sql or shuffle feature off, the corresponding daemon prints build with feature flight-sql / build with feature shuffle and exits 2.
UI on local / cluster
When started via local start or cluster start, the operator UI is mounted at http://<http-addr>/ui. UI for routes and security.