Go to file
Jeremy Latt 6d194e3d94 update readme 2014-03-01 14:45:23 -08:00
irc switch to gcfg for conf file 2014-03-01 14:38:01 -08:00
.gitignore remove unnecessary ignores 2014-02-09 21:07:58 -08:00
LICENSE MIT license 2014-02-25 09:54:14 -08:00
README.md update readme 2014-03-01 14:45:23 -08:00
ergonomadic.conf switch to gcfg for conf file 2014-03-01 14:38:01 -08:00
ergonomadic.go switch to gcfg for conf file 2014-03-01 14:38:01 -08:00

README.md

Ergonomadic

Ergonomadic is an IRC daemon written from scratch in Go. Pull requests and issues are welcome.

Some Features

  • follows the RFC where possible
  • gcfg gitconfig-style 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)

Why?

I wanted to learn Go.

Whats with the name?

“Ergonomadic” is an anagram of “Go IRC Daemon”.

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.

Installation

go get
go install
ergonomadic -conf '/path/to/config.json' -initdb

Configuration

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

ergonomadic -genpasswd 'hunter2!'

Running the Server

ergonomadic -conf '/path/to/config.json'

Helpful Documentation