mirror of
				https://github.com/ergochat/ergo.git
				synced 2025-10-25 11:57:22 +02:00 
			
		
		
		
	
		
			
				
	
	
		
			63 lines
		
	
	
		
			1.9 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			63 lines
		
	
	
		
			1.9 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
|    ___ _ __ __ _  ___  
 | |
|   / _ \ '__/ _` |/ _ \ 
 | |
|  |  __/ | | (_| | (_) |
 | |
|   \___|_|  \__, |\___/ 
 | |
|             __/ |      
 | |
|            |___/       
 | |
| -----------------------------------------------------------------------------------------------
 | |
| 
 | |
| 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
 | 
