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 8c6a3170ee
Remove Github workflows
3 months ago
grafana Add grafana dashboard 3 years ago
irc Update module path for DanielOaks/girc-go to reflect new path goshuirc (#85) 8 months ago
scripts Fixed scripts/release.sh to correctly produce linux binaries for both amd64 and arm64 (#18) 4 years ago
.gitignore Updated depednenices 1 year ago
.goreleaser.yml Remove silly build token in version and add goreleaser config 4 years ago
.yamllint.yml Migrate to Github Actions Workflows 1 year ago
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md (#50) 3 years ago
CONTRIBUTING.md Fix import paths 3 months ago
Dockerfile Remove silly build token in version and add goreleaser config 4 years ago
LICENSE Renamed project to eris 4 years ago
Makefile Migrate to Drone CI, Codecov and Go11Modules 3 years ago
PULL_REQUEST_TEMPLATE.md Create PULL_REQUEST_TEMPLATE.md 3 years ago
README.md Fix import paths 3 months ago
_config.yml Set theme jekyll-theme-architect 3 years ago
docker-compose.yml Add Docker stack file 4 years ago
go.mod Fix import paths 3 months ago
go.sum Bump golang.org/x/text from 0.3.5 to 0.3.6 (#92) 5 months ago
ircd.yml Fix import paths 3 months ago
main.go Fix import paths 3 months ago
main_test.go Fix import paths 3 months ago

README.md

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 irc.mills.io +6697 (use TLS/SSL)
  • /join #lobby

Or (not recommended):

  • /server irc.mills.io (default port 6667, non-TLS)
  • /join #lobby

Features

  • 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 git.mills.io/prologic/eris
$ cat > ircd.yml <<EOF
network:
  name: Test
server:
  name: Test
  listen:
    - ":6667"
EOF
$ eris

If you want TLS (recommended) then:

$ go get git.mills.io/prologic/mksslcert
$ mksslcert

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

Then add a tlslisten block to your config:

server:
  tlslisten:
    ":6697":
      key: key.pem
      cert: cert.pem

Installation

$ go install git.mills.io/prologic/eris
$ eris --help

Configuration

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 git.mills.io/prologic/mkpasswd
$ mkpasswd

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

$ go install git.mills.io/prologic/mksslcert
$ mksslcert

Deployment

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

Cloud

Desktop

Mobile

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

Web

  • 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

License

eris is licensed under the MIT License.