2 Home

Jean edited this page 2026-07-21 14:39:14 +00:00

Table of Contents

• echo
• Pages
• What echo is

echo

Services for an IRC network, built for InspIRCd, in Rust. This wiki is the reference: the services and their commands, the full configuration, the design, and how to extend it.

Pages

• Services: every service and its commands, with examples
• Configuration: the complete config.toml reference
• Architecture: the engine, the event log, the module boundary
• Directory API: the gRPC directory a website uses to mirror accounts and channels
• Deployment: running echo in production, with backups and durability
• Writing a Module: add a service or an ircd protocol

What echo is

echo links to an InspIRCd server over the server-to-server protocol and runs the network's services, NickServ, ChanServ, and about a dozen more, as pseudo-clients. There is no database: every change is one event appended to a log, and the running state is a fold over that log. The engine handles one event at a time, so there are no locks on the shared state. Each service is its own crate, walled off from the log and from anything that holds a password.

echo can also run as more than one node sharing a database. That is optional, and most setups never need it.