Download and Install

  1. Download the latest source tarball. wget http://znc.in/releases/znc-latest.tar.gz
  2. Extract the downloaded archive. tar -xzvf znc*.*gz
  3. Make the newly extracted folder your working directory. cd znc-*
  4. Configure the installation. ./configure --prefix=$HOME/znc
  5. Begin compilation of the application using the settings used in the previous step. make clean; make
  6. Install the application. make install
    Steps 5 and 6 can take some time, so just wait for it to complete.
  7. (Optional) Clean up installation files. rm -r ~/znc-*


A random port number between 10000 and 65535 is needed and will be used to access ZNC once setup is complete. The port number 17203 has automatically been generated and will be used throughout this article, but can be changed if needed.

  1. Generate an initial configuration. ~/znc/bin/znc --makeconf
  2. At the least, you should worry about enabling the WebAdmin module when prompted. Make sure to select a valid port above 10000. Afterwards, you can access the web interface at http://server.whatbox.ca:17203(use https if you had the configuration use SSL).


After the initial configuration has been generated, ZNC will automatically start. If you need to restart it in the future, run ~/znc/bin/znc.

An optional step is to add a @reboot line to your crontab, so that if the server is rebooted for any reason, ZNC will automatically restart. See the Cron wiki article for information on how to edit your crontab. The correct job syntax for restarting ZNC is @reboot /home/user/znc/bin/znc


See the official ZNC wiki for a list of modules that can be enabled, as well as their respective uses.


Sometimes system updates performed on the server will upgrade the libraries that ZNC depends on, leading to error messages similar to the following:

/home/user/znc/bin/znc: error while loading shared libraries: libicuuc.so.55: cannot open shared object file: No such file or directory

In the event that this happens, you will need to recompile (and optionally upgrade) ZNC by following the Download and Install directions again and starting ZNC with ~/znc/bin/znc. To only perform the recompile, start at step #3, otherwise start at step #1 to perform any available upgrades. Because ZNC is already configured, the Configuration section does not need to be performed again.

If you have any configurations that you cannot lose, you may first want to backup ~/znc and ~/.znc in case anything goes wrong with the installation.