LLI Wiki — My Digital Knowledge Base

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")

ZNC Network Info page

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.

ZNC module list with nickserv and simple_away ticked

Connecting from HexChat

In HexChat, create a network pointing to ZNC:

HexChat network configuration window

Notes

Mastodon LLIMastodon SocialFosstodon