# Ghoti > Ghoti is a single-binary, in-memory server for coordination primitives. It gives a fleet of services up to 1,000 configurable slots (token-bucket and leaky-bucket rate limiters, timeout-memory leases, atomic counters, tickers, simple memory, broadcast and multicast channels) over a plain-text TCP protocol (`standard` or `telnet`) or HTTP with Server-Sent Events. No client library is required. Key facts: - All state is in memory. A restart empties every slot; nothing is persisted. - Values are opaque byte strings of at most 36 bytes; requests are 4 to 40 bytes; one request in flight per connection. - Commands: `r` read, `w` write, `s`/`d` subscribe/leave (multicast), `u`/`p` login, `q` quit. Responses start with `v` (value), `e` (error, `e`) or `a` (async event). - Start the server with `ghoti run`; it reads `config.yaml` from `/etc/ghoti`, `$HOME/.ghoti` or the current directory and exits if none is found. Default address `localhost:9090`. - No TLS on any listener. Broadcast/multicast delivery is at most once. Clustering (leader election, no replication) is experimental. - Latest release: v0.3.0. License: Apache-2.0. Source: https://github.com/dankomiocevic/ghoti ## Start - [Overview](https://ghoti.miocevic.com/docs/): What Ghoti is and isn't: slot kinds, transports, durability, ordering and delivery guarantees at a glance, and when it fits your system. - [Getting started](https://ghoti.miocevic.com/docs/getting-started/): Run Ghoti and get your first answers in four commands, then install from a release archive, verify the download, and troubleshoot a first run. - [Concepts](https://ghoti.miocevic.com/docs/concepts/): Slots, volatile state, connections and ownership, and the one-request-in-flight rule. ## Protocol - [Protocol](https://ghoti.miocevic.com/docs/protocol/): Ghoti's plain-text protocol: framing and limits, commands, responses, ordering, and which commands are safe to retry. - [Transports](https://ghoti.miocevic.com/docs/protocol/transports/): The standard, telnet and http transports, line endings, HTTP status mapping, timeouts, SSE heartbeats and backpressure. ## Configure - [Configuration](https://ghoti.miocevic.com/docs/configuration/): Where Ghoti reads config.yaml, GHOTI_ environment variables, and the addr, protocol, max_connections and log settings. - [Slot reference](https://ghoti.miocevic.com/docs/configuration/slots/): Every slot kind (simple memory, timeout memory, token bucket, leaky bucket, ticker, atomic, broadcast, multicast) with its options and exact behaviour. - [Authentication](https://ghoti.miocevic.com/docs/authentication/): Users, per-slot permissions, the exact login rules, and why passwords travel in cleartext. ## Run - [Operations](https://ghoti.miocevic.com/docs/operations/): Running Ghoti in production: Prometheus metrics, connection limits, deployment, shutdown and TLS termination. - [Cluster](https://ghoti.miocevic.com/docs/cluster/): Experimental leader election between Ghoti nodes with the bully algorithm and no replication: configuration, routing, failure scenarios and limits. ## Reference - [Error codes](https://ghoti.miocevic.com/docs/reference/errors/): Every error code Ghoti returns, with its name, meaning and when it closes the connection. - [Contributing](https://ghoti.miocevic.com/docs/contributing/): How to build, test and contribute to Ghoti, how CI checks a pull request, and how to report a security issue. ## Benchmarks - [Benchmarks](https://ghoti.miocevic.com/benchmarks/): Ghoti v0.3.0 on a 2-vCPU, 1-GiB AWS t4g.micro: 134,000 reads/s at 0.60 ms median round trip with 100 connections, 0 errors in 255M requests. ## Tutorials - [Implementing leader election with Ghoti](https://ghoti.miocevic.com/blog/2025/07/25/implementing-leader-election-with-ghoti/): Use a timeout memory slot as a lease so that only one of your nodes acts as leader, and learn exactly where the approach stops being safe. ## Optional - [Full documentation as one file](https://ghoti.miocevic.com/llms-full.txt): every docs page, the benchmarks and the tutorial in Markdown. - [Error codes source of truth](https://github.com/dankomiocevic/ghoti/blob/main/internal/errs/README.md): embedded into the server binary. - [Security policy](https://github.com/dankomiocevic/ghoti/blob/main/SECURITY.md) - [Changelog](https://github.com/dankomiocevic/ghoti/blob/main/CHANGELOG.md)