From ArchWiki

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


Note: If you previously installed znc (version <1.9) and used /var/lib/znc/.znc/ you will need to mv /var/lib/znc/.znc/ /var/lib/znc/ and edit the contents of znc.conf to use the new directory. Alternatively override the unit to use the old path in ExecStart.

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 and shell is /usr/bin/nologin.

Generate ZNC configuration as the znc user:

[znc]$ znc --makeconf --datadir /var/lib/znc

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


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

Warning: Do not edit /var/lib/znc/configs/znc.conf while ZNC is running. There is a good chance you will lose your configuration. Use the webadmin or controlpanel modules, which are included in the package, to change settings on-the-fly.

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