mirror of
				https://github.com/ergochat/ergo.git
				synced 2025-11-03 23:37:22 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			64 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			64 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
 | 
						|
                                 ▄▄▄   ▄▄▄·  ▄▄ •        ▐ ▄       
 | 
						|
                           ▪     ▀▄ █·▐█ ▀█ ▐█ ▀ ▪▪     •█▌▐█▪     
 | 
						|
                            ▄█▀▄ ▐▀▀▄ ▄█▀▀█ ▄█ ▀█▄ ▄█▀▄▪▐█▐▐▌ ▄█▀▄ 
 | 
						|
                           ▐█▌.▐▌▐█•█▌▐█ ▪▐▌▐█▄▪▐█▐█▌ ▐▌██▐█▌▐█▌.▐▌
 | 
						|
                            ▀█▄▀▪.▀  ▀ ▀  ▀ ·▀▀▀▀  ▀█▄▀ ▀▀ █▪ ▀█▄▀▪
 | 
						|
 | 
						|
-----------------------------------------------------------------------------------------------
 | 
						|
 | 
						|
Oragono 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://oragono.io/
 | 
						|
                              https://github.com/oragono/oragono
 | 
						|
                                     #oragono on Freenode
 | 
						|
 | 
						|
-----------------------------------------------------------------------------------------------
 | 
						|
 | 
						|
 | 
						|
=== 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:
 | 
						|
 | 
						|
    $ oragono genpasswd
 | 
						|
 | 
						|
If you need to generate self-signed TLS certificates, use this command:
 | 
						|
 | 
						|
    $ oragono mkcerts
 | 
						|
 | 
						|
You are now ready to start Oragono!
 | 
						|
 | 
						|
    $ oragono 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://oragono.io/manual.html
 | 
						|
 | 
						|
=== Updating ===
 | 
						|
 | 
						|
If you're updating from a previous version of Oragono, 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
 |