# socketley > One Linux daemon and CLI that runs your servers, proxies, caches, storage, databases, DNS, sign-in, MQTT, mail, metrics, tunnels and MCP: each a runtime made with one command. socketley is a single Linux binary. `socketley daemon` supervises runtimes; every other invocation is the CLI that talks to the daemon over a unix socket. A runtime is a network service of one of 15 types, made with `socketley create [flags]`, each in its own worker process on an io_uring event loop, scriptable in Lua. The manual page man/socketley.1 is the source of truth; these files are generated from it and from the site's own pages (https://hiimsmiley.github.io/Socketley/). Every page below is plain Markdown. llms-full.txt is all of them in one file (large). ## Start - [socketley](llms/index.txt): One Linux daemon and CLI that runs your servers, proxies, caches, storage, databases, DNS, sign-in, MQTT, mail, metrics, tunnels and MCP: each a runtime made with one command. - [Install](llms/install.txt): From source, the install script or a Debian package; the daemon then runs as a systemd service. - [Ten-minute tour](llms/tour.txt): Make a server, a cache and a proxy, script one of them, and look at all three. - [Concepts](llms/concepts.txt): The daemon, its runtimes and the few rules every one of them follows. - [How it works](llms/how.txt): What happens, and where, from the command you type to the answer a client gets. ## Runtimes - [cache runtime](llms/rt-cache.txt): In-memory store on the Redis protocol: strings, lists, sets, hashes, sorted sets, streams, pub/sub - [client runtime](llms/rt-client.txt): Dials a server and holds the connection: TCP, UDP or a unix socket, over TLS, reconnecting - [db runtime](llms/rt-db.txt): JSON documents owned by accounts, over HTTP, with indexes, queries, replicas and backups - [dns runtime](llms/rt-dns.txt): Authoritative name server for its zones, over UDP and TCP, with DNSSEC and transfers - [idp runtime](llms/rt-idp.txt): OpenID Connect provider with its own accounts, second factors, app passwords and SSH certificates - [mail runtime](llms/rt-mail.txt): Mail server: SMTP, submission, IMAP, POP3, JMAP and webmail, mailboxes in a storage - [mcp runtime](llms/rt-mcp.txt): A Model Context Protocol server: the tools, resources and prompts its script declares, for AI clients - [metrics runtime](llms/rt-metrics.txt): Time series for years, answered with PromQL over the Prometheus API, with alert rules and logs - [mqtt runtime](llms/rt-mqtt.txt): MQTT 3.1, 3.1.1 and 5.0 broker on TCP, TLS and WebSocket, with sessions and rules - [proxy runtime](llms/rt-proxy.txt): HTTP and TCP reverse proxy: routes by name and path, health checks, retries, mTLS, FastCGI - [server runtime](llms/rt-server.txt): TCP, UDP, WebSocket and HTTP on one port, answered by Lua or by a built-in path - [storage runtime](llms/rt-storage.txt): S3 object storage over a directory, with versioning, replication, a web drive and git - [sync runtime](llms/rt-sync.txt): One job that carries a directory to a storage, from it, or both ways - [tunnel runtime](llms/rt-tunnel.txt): Makes a machine without an address of its own reachable through an edge it dials - [web runtime](llms/rt-web.txt): Static site of files for browsers: a docs site, a blog, a single-page app; caching and compression built in ## Guides - [Lua scripting](llms/lua.txt): Callbacks per message, connection and request, the runtime methods a script calls, and what a script may not do. - [Deployment](llms/deploy.txt): Running socketley on a machine that matters: the service, permissions, TLS, state, backups and limits. - [Operating it](llms/operate.txt): Is it running, where the log is, why a runtime failed, and what blocks it. - [Cluster](llms/cluster.txt): Daemons on several machines that see each other's runtimes, and the opt-in Raft mode. - [C++ SDK](llms/sdk.txt): Control a daemon, embed the engine, or attach a process of your own to a daemon. - [Examples](llms/examples.txt): Every script and program in examples/ and sdk/examples/. ## Reference - [CLI](llms/cli.txt): Every command socketley takes, with its options. - [All flags](llms/flags.txt): Every flag of every runtime type, with the types that take it. - [Environment & files](llms/env.txt): The variables the daemon and the CLI read, and where everything lives on disk. - [Benchmarks](llms/bench.txt): Each runtime against what people run instead, on one machine, in one run. ## Manual sections - [Manual](llms/man.txt): The manual page socketley(1), one file per section. - [Manual: Name](llms/man-name.txt): The manual page's Name section. - [Manual: Synopsis](llms/man-synopsis.txt): The manual page's Synopsis section. - [Manual: Description](llms/man-description.txt): The manual page's Description section. - [Manual: Commands](llms/man-commands.txt): The manual page's Commands section. - [Manual: Daemon flags](llms/man-daemon-flags.txt): The manual page's Daemon flags section. - [Manual: Common flags](llms/man-common-flags.txt): The manual page's Common flags section. - [Manual: Server flags](llms/man-server-flags.txt): The manual page's Server flags section. - [Manual: Client flags](llms/man-client-flags.txt): The manual page's Client flags section. - [Manual: Proxy flags](llms/man-proxy-flags.txt): The manual page's Proxy flags section. - [Manual: Cache flags](llms/man-cache-flags.txt): The manual page's Cache flags section. - [Manual: Storage flags](llms/man-storage-flags.txt): The manual page's Storage flags section. - [Manual: DNS flags](llms/man-dns-flags.txt): The manual page's DNS flags section. - [Manual: Sync flags](llms/man-sync-flags.txt): The manual page's Sync flags section. - [Manual: IDP flags](llms/man-idp-flags.txt): The manual page's IDP flags section. - [Manual: DB flags](llms/man-db-flags.txt): The manual page's DB flags section. - [Manual: MQTT flags](llms/man-mqtt-flags.txt): The manual page's MQTT flags section. - [Manual: Mail flags](llms/man-mail-flags.txt): The manual page's Mail flags section. - [Manual: Tunnel flags](llms/man-tunnel-flags.txt): The manual page's Tunnel flags section. - [Manual: Metrics flags](llms/man-metrics-flags.txt): The manual page's Metrics flags section. - [Manual: MCP flags](llms/man-mcp-flags.txt): The manual page's MCP flags section. - [Manual: Web flags](llms/man-web-flags.txt): The manual page's Web flags section. - [Manual: Registered types](llms/man-registered-types.txt): The manual page's Registered types section. - [Manual: Lua configuration](llms/man-lua-configuration.txt): The manual page's Lua configuration section. - [Manual: Dashboard](llms/man-dashboard.txt): The manual page's Dashboard section. - [Manual: Service mesh](llms/man-service-mesh.txt): The manual page's Service mesh section. - [Manual: Runtime states](llms/man-runtime-states.txt): The manual page's Runtime states section. - [Manual: Examples](llms/man-examples.txt): The manual page's Examples section. - [Manual: Cluster mode](llms/man-cluster-mode.txt): The manual page's Cluster mode section. - [Manual: Installation](llms/man-installation.txt): The manual page's Installation section. - [Manual: State persistence](llms/man-state-persistence.txt): The manual page's State persistence section. - [Manual: Environment](llms/man-environment.txt): The manual page's Environment section. - [Manual: Files](llms/man-files.txt): The manual page's Files section. - [Manual: C++ SDK](llms/man-c-sdk.txt): The manual page's C++ SDK section. - [Manual: Limitations](llms/man-limitations.txt): The manual page's Limitations section. - [Manual: Exit status](llms/man-exit-status.txt): The manual page's Exit status section. - [Manual: See also](llms/man-see-also.txt): The manual page's See also section. - [Manual: Bugs](llms/man-bugs.txt): The manual page's Bugs section. - [Manual: Authors](llms/man-authors.txt): The manual page's Authors section.