Skip to main content

Initial Setup and Configuration

In this guide, you'll be setting up ZNC and adding your first network. Listed are the goals of this tutorial:

  • Changing default ZNC Password
  • Setting up global and network modules
  • Adding your first IRC network
  • Connecting your ZNC browser to your IRC client

Initial Setup

First Login and Changing ZNC Password

  • When clicking Connect, you'll be greeted with the login page of ZNC's Web Interface

  • Login using the default credentials
Default ZNC Login Credentials

Username: admin
Password: admin

  • To change the password, go to Your Settings and set your password new password accordingly.
    • You do not need to change the other settings under Authentication

  • Scroll down to the bottom of the page and click Save and Continue

Setting your first IRC Server to ZNC

  • First, on the same page under IRC Information_,_ edit the following information listed according to your preferences.
    • Nickname
    • Alt. Nickname
    • Ident (Username)
    • Realname
    • Quit message
  • This section will apply said information to all future networks.
    • You can also set different nicks, idents and such per network.

  • Once that's done, scroll down to the bottom and click Save and Continue

  • To create your first ZNC Network (your IRC Network) by clicking Add under Your Settings -> Network

  • Set a name. In this setup, we'll be connecting to Freenode. We'll name this first network Freenode
    • If you have registered on this IRC network or you prefer another nick/ident for this network, you may change so here.

  • Uncheck Connect to IRC & automatically re-connect.

  • On Servers of this IRC network, click Add

  • Then add the hostname and the port of the IRC network you're connecting with.
    • If you're registered, DO NOT put your server/NickServ password in the Password field

  • Scroll down a bit and check the modules you need.

  • Listed below are our recommended modules. Your choice of modules may vary, depending on your needs.

    • crypt
      • It encrypts channel/private messages
    • keepnick
      • This module keeps on trying to get your preferred nick
    • kickrejoin
      • Automatically rejoin channels after being kicked
    • modules_online
      • Makes ZNC's *modules to be "online"
        • This is useful if you're using multiple IRC clients connected to ZNC
    • route_replies
      • It send replies (e.g. to /who) to the right client only,
      • Prevents the client to excessively send /who requests
      • It is also useful if you're using multiple IRC clients
    • sasl or nickserv
      • This is where you'll put your IRC password

If you're using sasl, you'll put your IRC credentials under Network modules of your network.

You'll see this on either the left or right hand side of the page (depending on the theme) after you have saved your config.

If you're using nickserv, input your IRC password on the textbox beside it

  • perform
    • It executes your set commands after ZNC is successfully connected to the IRC network

  • Click save and continue to save your changes.
  • Now you'll notice a message on the top of the page saying "To connect to this network from your IRC client, you can set the server password field as admin/network_name:<znc_password> or username field as admin/network_name." Take note of that.

Connecting your IRC Client to ZNC

Hexchat

  • Open hexchat and make sure that your Hexchat username the same as the one you set on ZNC
  • Open Network List and click Add. Type any name you want and hit Enter.

[![ye.png](https://docs.usbx.me/uploads/images/gallery/2019-12/scaled-1680-/ye.png">

](https://docs.usbx.me/uploads/images/gallery/2019-12/ye.png">

  • Highlight the Network you just made and Click Edit
  • Click the text named newserver/6667 and input there lwxxx.ultraseedbox.com/ZNC_webui_port, inputting the hostname of your server and the ZNC port shown on UCP.

  • Then check the following
    • Connect to this Network automatically

  • Uncheck Use global user information and on User name field, put in admin/network_name, replacing network_name with the name you set in ZNC
  • In login method, select Server password (/PASS password)
  • On Password, input your set ZNC password.
  • Check if everything is correct. Once confirmed, Click Close, highlight your new network and click Connect

  • You'll be connected to your ZNC browser if you'll see the message Welcome to ZNC

[![sds.png](https://docs.usbx.me/uploads/images/gallery/2019-12/scaled-1680-/sds.png">

](https://docs.usbx.me/uploads/images/gallery/2019-12/sds.png">

Initializing Connection from your ZNC bouncer to your IRC network

  • In your IRC window, type in /znc connect.

  • If configured properly, you'll be greeted by your IRC network's Message of the Day.

Settings Overview

Global Settings

  • This is where you'll change themes and enable Global Modules.
  • It's recommended not to touch any of the settings here except
    • Skin
    • Maximum Buffer Size

Your Settings

  • Here, you can change your Authentication details per user, IRC information, Add or edit networks, Enable per-network modules and settings that alter ZNC behavior.

Traffic Info

  • Here, your ZNC traffic and storage stats are shown
  • It also shows your users' traffic info

Manage Users

  • Here, you can see the list of the registered users in your ZNC bouncer.

Back to top