:set spell eris - IRC Server / Daemon written in Go
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.
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.
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.
- /server irc.mills.io +6697 (use TLS/SSL)
- /join #lobby
Or (not recommended):
- /server irc.mills.io (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)
$ go get github.com/prologic/eris $ cat > ircd.yml <<EOF network: name: Test server: name: Test listen: - ":6667" EOF $ eris
If you want TLS (recommended) then:
$ go get github.com/prologic/mksslcert $ mksslcert
This generates a self-signed cert
key.pem into the
Then add a
tlslisten block to your config:
server: tlslisten: ":6697": key: key.pem cert: cert.pem
$ go install github.com/prologic/eris $ eris --help
$ go install github.com/prologic/mkpasswd $ mkpasswd
Self-signed certificates can also be generated using the
$ go install github.com/prologic/mksslcert $ mksslcert
To run simply run the
eris binary (assuming a
ircd.yml in the current directory):
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
Recommended Mobile clients
- 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.
There is no documentation for this package.