mirror of
				https://github.com/ergochat/ergo.git
				synced 2025-11-03 15:27:26 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			63 lines
		
	
	
		
			2.0 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			63 lines
		
	
	
		
			2.0 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
 | 
						|
* High customizability via a rehashable (i.e., reloadable at runtime) 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
 |