Skip to content

znc | Cheatsheet

ZNC is an IRC network bouncer or BNC. It can detach the client from the actual IRC server, and also from selected channels. Multiple clients from different locations can connect to a single ZNC account simultaneously and therefore appear under the same nickname on IRC.

It supports Transport Layer Security connections and IPv6.


emerge --ask net-irc/znc
apt install build-essential libssl-dev libperl-dev pkg-config libicu-dev znc 
git clone
cd znc
git submodule update --init --recursive
./configure --disable-ipv6 --enable-openssl 
make -j${nproc}
make install

Configure ZNC

znc --makeconf

Signed SSL certificate

certbot certonly -d
cat /etc/letsencrypt/live/{privkey,fullchain}.pem > ~/.znc/znc.pem
  • Automating znc.pem creation
cat << "EOF" > /etc/letsencrypt/renewal-hooks/deploy/update-znc.pem

[[ $RENEWED_LINEAGE != "/etc/letsencrypt/live/${domain}" ]] && exit 0
echo "Updating certs"

Important: You must chmod the script before it can be used in background

chmod +x /etc/letsencrypt/renewal-hooks/deploy/update-znc.pem

Now browse to and configure znc