eris is a modern IRC Server / Daemon written in Go that has a heavy focus on security and privacy
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
James Mills 807abffb60 Bump from 0.1.0 to 0.2.0 (#93) 11 months ago
grafana Add grafana dashboard 5 years ago
irc Update module path for DanielOaks/girc-go to reflect new path goshuirc (#85) 2 years ago
scripts Fixed scripts/ to correctly produce linux binaries for both amd64 and arm64 (#18) 5 years ago
.gitignore Updated depednenices 3 years ago
.goreleaser.yml Remove silly build token in version and add goreleaser config 5 years ago
.yamllint.yml Migrate to Github Actions Workflows 3 years ago Create (#50) 5 years ago Fix import paths 2 years ago
Dockerfile Remove silly build token in version and add goreleaser config 5 years ago
LICENSE Renamed project to eris 5 years ago
Makefile Migrate to Drone CI, Codecov and Go11Modules 4 years ago Create 5 years ago Fix import paths 2 years ago
_config.yml Set theme jekyll-theme-architect 4 years ago
docker-compose.yml Add Docker stack file 5 years ago
go.mod Bump from 0.1.0 to 0.2.0 (#93) 11 months ago
go.sum Bump from 0.1.0 to 0.2.0 (#93) 11 months ago
ircd.yml Fix import paths 2 years ago
main.go Fix import paths 2 years ago
main_test.go Fix import paths 2 years ago

eris - IRC Server / Daemon written in Go

Build Status CodeCov Go Report Card GoDoc Sourcegraph

This project and repository is based off of ergonomadic and much of my original contributions were made in my fork of ergonomadic but the upstream project was ultimately shutdown.

This repository intends to create a new history and improve upon prior work.

In philosophy and rhetoric, eristic (from Eris, the ancient Greek goddess of chaos, strife, and discord) refers to argument that aims to successfully dispute another's argument, rather than searching for truth. According to T.H.

From Eris and Eristic

The connotation here is that IRC (Internet Relay Chat) is a place of chaos, strife and discord. IRC is a place where you argue and get into arguments for the sake of argument.

So eris is an IRC daemon written from scratch in Go to facilitate discord and have arguments for the sake of argument!

Pull requests and issues are welcome.

Discussion at:

  • /server +6697 (use TLS/SSL)
  • /join #lobby

Or (not recommended):

  • /server (default port 6667, non-TLS)
  • /join #lobby


  • follows the RFCs where possible
  • UTF-8 nick and channel names
  • yaml configuration
  • server password (PASS command)
  • channels with most standard modes
  • IRC operators (OPER command)
  • passwords stored in [bcrypt][go-crypto] format
  • messages are queued in the same order to all connected clients
  • SSL/TLS support
  • Simple IRC operator privileges (overrides most things)
  • Secure connection tracking (+z) and SecureOnly user mode (+Z)
  • Secure channels (+Z)
  • Three layers of channel privacy, Public, Private (+p) and Secret (s)

Quick Start

$ go get
$ cat > ircd.yml <<EOF
  name: Test
  name: Test
    - ":6667"
$ eris

If you want TLS (recommended) then:

$ go get
$ mksslcert

This generates a self-signed cert cert.pem and key.pem into the $PWD.

Then add a tlslisten block to your config:

      key: key.pem
      cert: cert.pem


$ go install
$ eris --help


See the example ircd.yml. Passwords are base64-encoded bcrypted byte strings. You can generate them with the mkpasswd tool from prologic/mkpasswd:

$ go install
$ mkpasswd

Self-signed certificates can also be generated using the mksslcert tool from prologic/mksslcert:

$ go install
$ mksslcert


To run simply run the eris binary (assuming a ircd.yml in the current directory):

$ eris

Or you can deploy with Docker using the prebuilt prologic/eris:

docker run -d -p 6667:6667 -p 6697:6697 prologic/eris

You may want to customize the configuration however and create your own image based off of this; or deploy with docker stack deploy on a Docker Swarm clsuter like this:

$ docker stack deploy -c docker-compose.yml eris

Which assumes a ircd.yml coniguration file in the current directory which Docker will use to distribute as the configuration. The docker-compose.yml (Docker Stackfile) is available at the root of this repository.

There are a number of supported accompanying services that are being developed alongside Eris:

  • Soter -- An IRC Bot that persists channel modes and topics.
  • Cadmus -- An IRC Bot that logs channels and provides an interface for viewing and searching logs

CLI / Terminal




  • Palaver (iOS) -- SASL, TLS, Server Password, Push Notifications, IRCv3 (Also supports custom image upload service(s) for better privacy of shared photos/images over IRC)


  • Dispatch -- TLS, Multiple Servers and Users, Client Certificates
  • cadmus -- an IRC Bot written in Go that logs IRC Channels and provides an interface to view and search those logs
  • soter -- an IRC Bot written in Go that protects IRC Channels by persisting channel modes and topics


eris is licensed under the MIT License.