Go to file
Daniel Oaks 29d80366a6 Use docopt for command-line processing and new YAML configuration format 2016-04-13 08:46:14 +10:00
irc Use docopt for command-line processing and new YAML configuration format 2016-04-13 08:46:14 +10:00
.gitignore Use docopt for command-line processing and new YAML configuration format 2016-04-13 08:46:14 +10:00
LICENSE MIT license 2014-02-25 09:54:14 -08:00
README.md Use docopt for command-line processing and new YAML configuration format 2016-04-13 08:46:14 +10:00
ergonomadic.go Use docopt for command-line processing and new YAML configuration format 2016-04-13 08:46:14 +10:00
ergonomadic.yaml Use docopt for command-line processing and new YAML configuration format 2016-04-13 08:46:14 +10:00

README.md

Ergonomadic (anagram of “go IRC daemon”) is an IRC daemon written from scratch in Go. Pull requests and issues are welcome.

Discussion at: * host/port: irc.skub.club:6697, use SSL * password: smellyoulater * #darwin

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)
  • haproxy PROXY protocol header for hostname setting
  • passwords stored in bcrypt format
  • channels that persist between restarts (+P)
  • messages are queued in the same order to all connected clients

What about SSL/TLS support?

Go has a not-yet-verified-as-safe TLS 1.2 implementation. Sadly, many popular IRC clients will negotiate nothing newer than SSLv2. If you want to use SSL to protect traffic, I recommend using stunnel version 4.56 with haproxys PROXY protocol. This will allow the server to get the clients original addresses for hostname lookups.

What about federation?

IRC federation solves a problem that was more likely to occur on the internet of 1991 than today. We are exploring alternatives to federation that avoid nickname and channel sync issues created during netsplits.

Installation

go get
go install
cp ergonomadic.yaml ircd.yaml
vim ircd.yaml  # modify the config file to your liking
ergonomadic initdb

Configuration

See the example ergonomadic.yaml. Passwords are base64-encoded bcrypted byte strings. You can generate them with the genpasswd subcommand.

ergonomadic genpasswd

Running the server

ergonomadic run

Credits