![Oragono logo](docs/logo.png)

Oragono is an IRC daemon written in Go. It's an early, experimental fork of the [Ergonomadic]( IRC daemon.

Also see the [mammon]( IRC daemon for a similar project written in Python instead.


[![Go Report Card](](


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
* native TLS/SSL support
* server password (`PASS` command)
* channels with most standard modes
* IRC operators
* ident lookups for usernames
* passwords stored in [bcrypt][go-crypto] format
* channels that persist between restarts (+P)
* client accounts and SASL
* IRCv3 support

### What about TLS/SSL?

There is inbuilt TLS support using the Go TLS implementation. However,
[stunnel]( version 4.56 with haproxy's
[PROXY protocol](
may also be used. This will allow the server to get the client's 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
oragono mkcerts

**Note:** This installation will give you unsigned certificates only suitable for teting purposes.
For real crets, look into [Let's Encrypt](

## Configuration

See the example [`oragono.yaml`](oragono.yaml). Passwords are stored using bcrypt. You can generate encrypted password strings for use in the config with the `genpasswd` subcommand.

oragono genpasswd

## Running the server

oragono run

## Credits

* Jeremy Latt, creator of Ergonomadic, <>
* Edmund Huber, maintainer of Ergonomadic, <>
* Niels Freier, added WebSocket support to Ergonomadic, <>
* Daniel Oakley, maintainer of Oragono, <>
* apologies to anyone I forgot.


Imports 4 package(s) ΒΆ