ZNC: configure an IRC network and connect with HexChat
Network settings in the ZNC IRC bouncer web interface, useful modules and HexChat client setup.
ZNC is an IRC bouncer: it stays connected to the IRC network for you and reattaches you from any client. This memo summarises the network settings in ZNC's web interface and the HexChat client setup used to connect to it.
Network settings in ZNC
On the "Network Info" page of the web interface:
| Setting | Purpose |
|---|---|
| Network Name | Name of the network on the ZNC side |
| Nickname / Alt. Nickname / Ident / Realname | Can be left empty, the user's value is then used |
| Quit Message | Message shown when ZNC quits (%bye bye% in the example) |
| Active | Connect to IRC and reconnect automatically |
| Disable certificate validation | Accepts any certificate ("INSECURE"); avoid outside of tests |
| Servers of this IRC network | Hostname, port (6697 in the example), SSL checkbox, optional password |
| SHA-256 fingerprints | Trusted certificate fingerprints, to fill in if validation is kept |
| Flood protection | Enabled, 2 seconds per line, burst of 9 lines in the example |
| Channel join delay | Delay before joining channels (0 seconds here) |
| Server encoding | UTF-8 recommended ("Try to parse as UTF-8 and as UTF-8, send as UTF-8") |
Modules
The module list lets you load modules per user ("Loaded by user") or globally. In the example, nickserv (authenticates with NickServ, the SASL module is preferred) and simple_away (sets you away on IRC when no client is connected) are ticked; chansaver keeps the channel list up to date.
Connecting from HexChat
In HexChat, create a network pointing to ZNC:
- server:
znc.example.com/6697(ZNC's listening host and port); - tick "Use SSL for all the servers on this network"; if ZNC uses a self-signed certificate, also tick "Accept invalid SSL certificates";
- Nick name and User name: the ZNC user, with the network as
user/network; - Login method: "Server password (/PASS password)" with the ZNC user's password;
- Character set: UTF-8.
Notes
- The
user/networkform is ZNC's convention for selecting the network at login. - Disabling certificate validation removes protection against server impersonation.