command module
Version: v1.6.6 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Dec 28, 2017 License: MIT Imports: 5 Imported by: 0


:set spell eris - IRC Server / Daemon written in Go

Build Status Go Report Card Coverage GoDoc Wiki

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
  • 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)


eris is licensed under the MIT License.


The Go Gopher

There is no documentation for this package.

Source Files


Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL