From ArchWiki

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


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 configuration as user znc.

$ sudo -u znc znc --makeconf

or if you use doas instead of sudo:

$ doas -u znc znc --makeconf

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/.znc/configs/znc.conf.

Warning: Do not edit /var/lib/znc/.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