This is an old revision of the document!


ZNC install for network Administrators

This guide tells how we install ZNC for our whole network, with integrated login to our X3 services.

Install ZNC

Assuming a debian 8 (jessie) base system:

  • Install debian backports: add deb http://ftp.debian.org/debian jessie-backports main to /etc/apt/sources.list. dont forget to sudo apt-get update
  • Install build dependencies by cheating a bit using the debian dependency list: sudo apt-get build-dep znc
  • Install CMake: sudo apt-get install cmake
  • Install ICU: sudo apt-get install libicu-dev
  • Install SWIG: sudo apt-get install swig3.0
  • Install Boost: sudo apt-get install libboost-all-dev
  • git clone the repository. We maintain some patches to ZNC for integration with sasl/ldap etc so you'll want to use the latest version branch from our znc fork: https://github.com/evilnet/znc
  • cd to the cloned repository
  • enable git submodules: git submodule update –init –recursive
  • compile: make
  • install: make install
  • Run for the first time, from the install directory: bin/znc –makeconf
    • Username: admin
    • Password: see keepass db (rubin)
    • Nickname: zncadmin
    • Ident: zncadmin
    • Real name: ZNC Administrator
    • Bind host: empty

Install saslauthd

  • Install saslauthd package: apt-get install sasl2-bin
  • edit /etc/defaults/saslauthd:
START=yes
MECHANISM="ldap"

* edit/create ''/etc/saslauthd.conf'':
ldap_servers: ldaps://yourldapserver.domain
ldap_search_base: ou=users,dc=yourdomain,dc=org
ldap_filter: (uid=%u)
ldap_tls_cert: /etc/ssl/yourcertificate.cer

* Copy the CA certificate matching your ldap server to /etc/ssl/yourcertificate.cer