2016-10-16 13:01:53 +02:00
|
|
|
|
|
|
|
|
▄▄▄ ▄▄▄· ▄▄ • ▐ ▄
|
|
|
|
|
▪ ▀▄ █·▐█ ▀█ ▐█ ▀ ▪▪ •█▌▐█▪
|
|
|
|
|
▄█▀▄ ▐▀▀▄ ▄█▀▀█ ▄█ ▀█▄ ▄█▀▄▪▐█▐▐▌ ▄█▀▄
|
|
|
|
|
▐█▌.▐▌▐█•█▌▐█ ▪▐▌▐█▄▪▐█▐█▌ ▐▌██▐█▌▐█▌.▐▌
|
|
|
|
|
▀█▄▀▪.▀ ▀ ▀ ▀ ·▀▀▀▀ ▀█▄▀ ▀▀ █▪ ▀█▄▀▪
|
|
|
|
|
|
|
|
|
|
-----------------------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
Oragono is a modern, experimental IRC server written in Go. It's designed to be simple to setup
|
|
|
|
|
and use, and to provide the majority of features that IRC users expect today.
|
|
|
|
|
|
|
|
|
|
It includes features such as UTF-8 nicks and channel names, client accounts and SASL, and other
|
|
|
|
|
assorted IRCv3 support.
|
|
|
|
|
|
2017-06-14 20:16:25 +02:00
|
|
|
https://oragono.io/
|
|
|
|
|
https://github.com/oragono/oragono
|
2016-10-16 13:01:53 +02:00
|
|
|
|
|
|
|
|
-----------------------------------------------------------------------------------------------
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
=== Installing ===
|
|
|
|
|
|
|
|
|
|
Copy the example config file to ircd.yaml with a command like:
|
|
|
|
|
|
|
|
|
|
$ cp oragono.yaml ircd.yaml
|
|
|
|
|
|
2017-10-10 23:48:31 +02:00
|
|
|
Modify the config file as you like. In particular, the `connection-throttling` and
|
|
|
|
|
`connection-limits` sections are working looking over and tuning for your network's needs.
|
2016-10-16 13:01:53 +02:00
|
|
|
|
2017-03-24 03:43:55 +01:00
|
|
|
To generate passwords for opers and connect passwords, you can use this command:
|
|
|
|
|
|
|
|
|
|
$ oragono genpasswd
|
|
|
|
|
|
2016-10-16 13:01:53 +02:00
|
|
|
Run these commands in order -- these will setup each section of the server:
|
|
|
|
|
|
|
|
|
|
$ oragono mkcerts
|
|
|
|
|
$ oragono run
|
|
|
|
|
|
|
|
|
|
And you should now be running Oragono!
|
2017-03-24 03:43:55 +01:00
|
|
|
|
|
|
|
|
|
|
|
|
|
=== Updating ===
|
|
|
|
|
|
|
|
|
|
If you're updating from a previous version of Oragono, checkout the CHANGELOG for a shortlist
|
|
|
|
|
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!
|
|
|
|
|
|
2019-02-23 12:58:42 +01:00
|
|
|
If there's been a database update, you can run this command to upgrade it manually:
|
2017-03-24 03:43:55 +01:00
|
|
|
|
|
|
|
|
$ oragono upgradedb
|
2017-10-08 01:45:34 +02:00
|
|
|
|
2019-02-23 12:58:42 +01:00
|
|
|
Otherwise, just starting the server will run an automagic backup and upgrade.
|
|
|
|
|
|
2017-10-08 01:45:34 +02:00
|
|
|
|
|
|
|
|
=== Credits ===
|
|
|
|
|
|
|
|
|
|
* Jeremy Latt, creator of Ergonomadic, <https://github.com/jlatt>
|
|
|
|
|
* Edmund Huber, maintainer of Ergonomadic, <https://github.com/edmund-huber>
|
|
|
|
|
* Niels Freier, added WebSocket support to Ergonomadic, <https://github.com/stumpyfr>
|
|
|
|
|
* Daniel Oakley, maintainer of Oragono, <https://github.com/DanielOaks>
|
|
|
|
|
* Euan Kemp, contributor to Oragono and lots of useful fixes, <https://github.com/euank>
|
|
|
|
|
* Shivaram Lingamneni, has contributed a ton of fixes, refactoring, and general improvements, <https://github.com/slingamn>
|
|
|
|
|
* James Mills, contributed Docker support, <https://github.com/prologic>
|
|
|
|
|
* Vegax, implementing some commands and helping when Oragono was just getting started, <https://github.com/vegax87>
|
|
|
|
|
* Sean Enck, transitioned us from using a custom script to a proper Makefile, <https://github.com/enckse>
|
|
|
|
|
* apologies to anyone I forgot.
|
