Skip to main content

Initial Setup

ZNC

Is an IRC network bouncer or BNC that is written in C++. It can detach the client from the actual IRC server and also from selected channels. Multiple clients from different locations can simultaneously connect to a single ZNC account and, therefore, appear under the same nickname on IRC. It has the following main features:

  • SSL secured connections
  • ZNC will remain connected to IRC even while you are offline
  • Multiple users support
  • Per Channel Playback Buffers
  • Modules support

For more information, you can visit this link.

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

  • ChangingYour defaultusername for ZNC Passwordwill be your service username and the password you set during the install procedure.
  • 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, identsidents, 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 FreenodeFreenode.

      • If you have registered on this IRC network or you prefer another nick/ident for this network,Network, you may change so here.

  • Uncheck
    • Uncheck `Connect to IRC & automatically re-connect.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 the Network modules of your network.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 sayingsaying, "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 as admin/username/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 named newserver/6667  and input there there lwxxx.ultraseedbox.com/usbx.me/ZNC_webui_port, inputting theyour server's hostname of your server and the ZNC port shown on UCP.

    • Then check the following

      • Connect to this Network automatically

    • Uncheck Use global user informationinformation, and on the User name field, put in admin/username/network_name, replacing 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 networkNetwork and click Connect

    • You'll be connected to your ZNC browser if you'll see the message 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,correctly, you'll be greeted by your IRC network's Message of the Day.

    • Back to top