Go to file
Daniel Oaks 4177522e74 modes: Correct mode argument handling, only first param is the modestring 2016-04-14 21:22:17 +10:00
irc modes: Correct mode argument handling, only first param is the modestring 2016-04-14 21:22:17 +10:00
.gitignore Add native SSL/TLS listener support from @enmand for our new config 2016-04-13 20:45:09 +10:00
CHANGELOG.md changelog: Mention mode changes 2016-04-14 18:43:19 +10:00
LICENSE MIT license 2014-02-25 09:54:14 -08:00
README.md version: Clarify semantic versioning "public API" and reset ver number on Oragono 2016-04-14 15:31:51 +10:00
oragono.go ergonomadic -> oragono. I'm making lots of changes and this is AN EXPERIMENT. I want to differentiate this from Ergonomadic proper 2016-04-13 08:55:37 +10:00
oragono.motd motd: Betterise logo 2016-04-13 11:42:52 +10:00
oragono.yaml Add native SSL/TLS listener support from @enmand for our new config 2016-04-13 20:45:09 +10:00

README.md

Oragono is a very early, extremely experimental fork of the Ergonomadic IRC daemon. Ergonomadic looks cool, and this is something I can experiment on. Hopefully most of the stuff I do in this can be merged back into Ergonomadic! Also see the mammon IRC daemon for something similar written in Python.

This project adheres to Semantic Versioning. For the purposes of versioning, we consider the “public API” to refer to the configuration files, CLI interface and database format.

Features

  • 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 format
  • channels that persist between restarts (+P)
  • messages are queued in the same order to all connected clients

What about SSL/TLS?

There is inbuilt TLS support using the Go TLS implementation. However, stunnel version 4.56 with haproxys PROXY protocol may also be used. This will allow the server to get the clients original addresses for hostname lookups.

Installation

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

Configuration

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

oragono genpasswd

Running the server

oragono run

Credits