oragono/README

                                 ▄▄▄   ▄▄▄·  ▄▄ •        ▐ ▄       
                           ▪     ▀▄ █·▐█ ▀█ ▐█ ▀ ▪▪     •█▌▐█▪     
                            ▄█▀▄ ▐▀▀▄ ▄█▀▀█ ▄█ ▀█▄ ▄█▀▄▪▐█▐▐▌ ▄█▀▄ 
                           ▐█▌.▐▌▐█•█▌▐█ ▪▐▌▐█▄▪▐█▐█▌ ▐▌██▐█▌▐█▌.▐▌
                            ▀█▄▀▪.▀  ▀ ▀  ▀ ·▀▀▀▀  ▀█▄▀ ▀▀ █▪ ▀█▄▀▪

-----------------------------------------------------------------------------------------------

Ergo is a modern IRC server written in Go. Its core design principles are:

* Being simple to set up and use
* Combining the features of an ircd, a services framework, and a bouncer:
  * Integrated account management
  * History storage
  * Bouncer functionality
* Bleeding-edge IRCv3 support
* Highly customizable via a rehashable (runtime-reloadable) YAML config

                                     https://ergo.chat/
                              https://github.com/ergochat/ergo
                          #ergo on irc.ergo.chat or irc.libera.chat

-----------------------------------------------------------------------------------------------


=== Installing ===

Copy the example config file to ircd.yaml with a command like:

    $ cp default.yaml ircd.yaml

Modify the config file as needed (the recommendations at the top may be helpful).

To generate passwords for opers and connect passwords, you can use this command:

    $ ergo genpasswd

If you need to generate self-signed TLS certificates, use this command:

    $ ergo mkcerts

You are now ready to start Ergo!

    $ ergo run

For further instructions, consult the manual. A copy of the manual should be
included in your release under `docs/MANUAL.md`. Or you can view it on the
Web: https://ergo.chat/manual.html

=== Updating ===

If you're updating from a previous version of Ergo, check out the CHANGELOG for a list
of important changes you'll want to take a look at. The change log details config changes,
fixes, new features and anything else you'll want to be aware of!

=== Credits ===

* Jeremy Latt (2012-2014)
* Edmund Huber (2014-2015)
* Daniel Oaks (2016-present)
* Shivaram Lingamneni (2017-present)
* Many other contributors and friends of the project <3