Difference between revisions of "ZNC"

From ArchWiki
Jump to: navigation, search
(Configuration: Added information on how to load a module on start since the default directory for Arch Linux does not match znc official documentation)
(Moved warning template to the configuration subsection since it is a warning regarding configuration and not installation)
Line 12: Line 12:
 
Generate ZNC config as user '''znc'''.
 
Generate ZNC config as user '''znc'''.
 
  $ sudo -u znc znc --makeconf
 
  $ sudo -u znc znc --makeconf
Go through the wizard and setup your preferences.
+
Go through the wizard and setup your preferences. [[Start/enable]] {{ic|znc.service}}.
{{warning|Do not edit configuration files manually in a text editor while ZNC is running. There is a very good chance you will lose your configuration. Use the webadmin or controlpanel modules to change settings on-the-fly. They are both included in the package.}}
 
 
 
[[Start/enable]] {{ic|znc.service}}.
 
  
 
== Configuration ==
 
== Configuration ==
 
Though you can choose to modify your configuration files manually, this requires shutting down the server first. '''Do not edit configuration files while ZNC is running'''. To load a module when {{ic|znc.service}} starts, add {{ic|LoadModule <nowiki>=</nowiki> <modulename>}} to the configuration file: {{ic|/var/lib/znc/.znc/configs/znc.conf}}.
 
Though you can choose to modify your configuration files manually, this requires shutting down the server first. '''Do not edit configuration files while ZNC is running'''. To load a module when {{ic|znc.service}} starts, add {{ic|LoadModule <nowiki>=</nowiki> <modulename>}} to the configuration file: {{ic|/var/lib/znc/.znc/configs/znc.conf}}.
 +
{{warning|Do not edit configuration files manually in a text editor while ZNC is running. There is a very good chance you will lose your configuration. Use the webadmin or controlpanel modules to change settings on-the-fly. They are both included in the package.}}
  
 
=== Webadmin Module ===
 
=== Webadmin Module ===

Revision as of 18:18, 23 January 2018

ZNC is an advanced IRC bouncer that is left connected so an IRC client can disconnect/reconnect without losing the chat session.

Installation

Install the znc package. The installation script will create a group and user znc. The default home directory for this user is /var/lib/znc.

Generate ZNC config as user znc.

$ sudo -u znc znc --makeconf

Go through the wizard and setup your preferences. Start/enable znc.service.

Configuration

Though you can choose to modify your configuration files manually, this requires shutting down the server first. Do not edit configuration files while ZNC is running. To load a module when znc.service starts, add LoadModule = <modulename> to the configuration file: /var/lib/znc/.znc/configs/znc.conf.

Warning: Do not edit configuration files manually in a text editor while ZNC is running. There is a very good chance you will lose your configuration. Use the webadmin or controlpanel modules to change settings on-the-fly. They are both included in the package.

Webadmin Module

If you enabled the web admin module, you can access it at http://yourhostname:port, the znc port number is the same as you defined for connecting to the bouncer.

Control Panel Module

If you enabled the control panel module, /msg *controlpanel help for a list of settings while you are connected to the server.

See also