2012-04-18 06:24:26 +02:00
|
|
|
# Ergonomadic
|
2012-04-18 06:23:12 +02:00
|
|
|
|
2014-02-22 03:51:50 +01:00
|
|
|
Ergonomadic is an IRC daemon written from scratch in Go.
|
2012-04-18 06:23:12 +02:00
|
|
|
|
2014-02-24 18:41:09 +01:00
|
|
|
## Some Features
|
|
|
|
|
|
|
|
|
|
- follows the RFC where possible
|
|
|
|
|
- JSON-based configuration
|
|
|
|
|
- server password
|
|
|
|
|
- channels with many standard modes
|
|
|
|
|
- IRC operators
|
|
|
|
|
- TLS support (but better to use stunnel with proxy protocol)
|
|
|
|
|
- haproxy PROXY protocol header for hostname setting
|
|
|
|
|
- passwords stored in bcrypt format
|
|
|
|
|
|
2013-05-25 06:39:53 +02:00
|
|
|
## Why?
|
2012-04-18 06:58:26 +02:00
|
|
|
|
|
|
|
|
I wanted to learn Go.
|
|
|
|
|
|
2013-05-25 06:39:53 +02:00
|
|
|
## What's with the name?
|
2012-04-18 06:58:26 +02:00
|
|
|
|
|
|
|
|
"Ergonomadic" is an anagram of "Go IRC Daemon".
|
2012-12-09 21:51:50 +01:00
|
|
|
|
2013-05-25 06:39:53 +02:00
|
|
|
## Helpful Documentation
|
|
|
|
|
|
2014-02-09 02:10:04 +01:00
|
|
|
- [RFC 1459: Internet Relay Chat Protocol](http://tools.ietf.org/html/rfc1459)
|
2013-05-25 06:39:53 +02:00
|
|
|
- [RFC 2811: IRC Channel Management](http://tools.ietf.org/html/rfc2811)
|
|
|
|
|
- [RFC 2812: IRC Client Protocol](http://tools.ietf.org/html/rfc2812)
|
|
|
|
|
- [RFC 2813: IRC Server Protocol](http://tools.ietf.org/html/rfc2813)
|
2014-02-14 08:16:07 +01:00
|
|
|
- [IRC/2 Numeric List](https://www.alien.net.au/irc/irc2numerics.html)
|
2013-05-25 06:39:53 +02:00
|
|
|
|
|
|
|
|
## Running the Server
|
2012-12-09 21:51:50 +01:00
|
|
|
|
2014-02-24 18:41:09 +01:00
|
|
|
See the example `config.json`. Passwords are base64-encoded bcrypted
|
|
|
|
|
byte strings. You can generate them with e.g. `ergonomadic -genpasswd
|
|
|
|
|
'hunter21!'`.
|
2014-02-10 00:15:02 +01:00
|
|
|
|
|
|
|
|
### from your GOPATH
|
|
|
|
|
|
|
|
|
|
```sh
|
2014-02-24 18:41:09 +01:00
|
|
|
go get
|
2014-02-10 00:15:02 +01:00
|
|
|
go install
|
2014-02-25 02:45:04 +01:00
|
|
|
ergonomadic -conf '/path/to/config.json'
|
2013-05-25 06:39:53 +02:00
|
|
|
```
|
