From ArchWiki
Revision as of 04:42, 23 December 2012 by Axanon (talk | contribs)
Jump to: navigation, search

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


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

Note: A bug in znc.install (znc 1.0-2) sets the znc user's home directory as /var/empty. /var/lib/znc is still created and owned by the correct user/group. You should change znc's home directory to /var/lib/znc

2. Generate ZNC config as user znc.

# su - znc
$ znc --makeconf

Go through the wizard and setup your preferences.

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.

3. To make ZNC start on boot:

# systemctl enable znc

Start and stop the ZNC daemon as usual by running:

# systemctl {start|stop|restart} znc

Webadmin Module

If you enabled the web admin module, you can access it at http://yourhostname:znc 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