Jump to content
From ArchWiki

Related articles

- PsyBNC

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 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`.

## Configuration

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

- ZNC's website
- ZNC modules

Category:

- Internet Relay Chat