Differences between revisions 2 and 3
Revision 2 as of 2017-08-22 15:43:28
Size: 2967
Comment: Added Let's encrypt info
Revision 3 as of 2017-08-22 15:57:54
Size: 3009
Comment: remove whitespace
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from ZNC IRC bouncer

When using the OFTC IRC network to interact with other Debian project members, developers, contributors and users, it is often useful to be able to keep a permanent connection to the network.

ZNC is an advanced IRC bouncer that can establish such a permanent connection to several IRC networks and channels so your IRC client (or multiple clients) can disconnect/reconnect without losing the chat session, while appearing as a single user to other users.

Once installed ZNC can be configured via its web interface or via IRC commands.

The default install includes SSL setup for secure web access, using a self-signed certificate.

Installing ZNC in Debian

ZNC is packaged for Debian so installation can be achieved by installing the znc package:

 sudo apt install znc

Once installed, you will need to generate an initial configuration:

 znc --makeconf

This will ask several questions, here are a few suggested answers:

  • Port: 6697 - this is usually the SSL-secure IRC port, it will also be used to access the web admin interface at https://$HOSTNAME:6697

Once you've finished initial configuration, access the web interface and explore the available modules. There are global and per-network modules that can be enabled.

SSL configuration with Let's Encrypt

See the ZNC documentation for information on Let's Encrypt SSL certificates setup.

Global and per-network configuration

Here are a few useful modules when using the OFTC network

  • In WebAdmin > Global Settings, enable the following modules:

    • ChanSaver - To keep channels joined/left updated when a user joins/parts. You shouldn't use autojoin feature on your client when ChanSaver is loaded.

    • lastseen - Collects data about when a user last logged in.

A few more post-install recommended steps:

  • Enable nickserv registration and primary nick selection:
    1. Under Manage Users click on Edit for your user

    2. Scroll down to Networks and click on Edit for the network you want to configure

      • If you are connecting to OFTC only using IPv4 (or experiencing connectivity problems), make sure the Network Info > BindHost value is 0.0.0.0

      • If you have a registered nickname, enable the nickserv module, specify your password in the adjacent field - it will be shown as hidden upon saving/reloading.

      • If you want ZNC to try and identify as your primary nick, enable the keepnick module

  • Under Your Settings > ZNC Behavior:

    • Setup your timezone
    • Setup Client encoding to Try to parse as UTF-8 and as _ , send as UTF-8