IRC Bouncer

Jump to:navigation Jump to:search

Web configuration

The IRC bouncer can easily be configured over the web interface:

Starting up

Use your browser to connect to and log in with your username and password.

ZNC User settings

Click on "Your Settings" to adjust your parameters. You'll default to log in to IRC, but you may want to change your username or add a different server.


Don't change the username+password sections. It won't change anything. This ZNC bouncer is set up using PAM to authenticate through your Linux username and password. I don't actually know what'll happen if you change it.

IRC Information

Nickname is the username that will be on IRC. This is not what you log in to, but this is what others will see.

The other IRC information is not really useful. Just choose an alternative nickname in case someone is trying to impersonate you: register your account to prevent this.


You will default with as a connected IRC with the username changeyourname.

You can add more networks if you want, but I'd be wary since MTULUG is running this bouncer, so they can see all your logs.


You can click on each module to read what each of them do, but I recommend making sure the log module is enabled (else there's really no point to the bouncer).

If you want personal logging, you'll need to a command on the shell server. Inside the server, type:

user $sudo setup-znc-logging

This will make a directory, ~/irslogs and all your new logs will be added there. You must keep write access to the _znc group so ZNC can write to the logs.

IRC connection

I'm going to explain this using HexChat since it's the simplest. If you want to use irssi or WeChat, you probably already know what's up, or how to look things up.

Honestly, mostly just follow ZNC's HexChat setup, but this is specifically for if there's something off.

HexChat Settings
  1. Open up Network List, Ctrl+S.
  2. Click Add (adding a new network, the ZNC bouncer)
    1. Set name to whatever you want, I use MTULUG Bouncer.
    2. Edit this network:
      1. Servers value should be:
      2. Check the Connect to this network automatically (if you want to connect to this network automatically...).
      3. Check the Use SSL for all the servers on this network.
      4. Do not accept invalid SSL certificates and do not use global user information.
      5. Nickname here is what you set as the nickname on the ZNC web interface.
      6. Second choice here is what you set as the alternative nickname on the ZNC web interface.
      7. Username is your shell username + /MTULUG or whatever Network Name on the ZNC web interface you chose.
        1. Example: sjwhitak-adm/MTULUG will auto-log in to the MTULUG server on the ZNC bouncer.
        2. Example: sjwhitak-adm/LiberaChat will auto-log in to the LiberaChat server on the ZNC bouncer.
      8. Login method set to Server password (/PASS password)
      9. Password here you type in your password.
  3. Close the configuration, then highlight this network and click Connect.

Suppose you have multiple networks, you'll need multiple connections to the ZNC. So, set this all up again but the Username parameter should have the <username>/MTULUG value changed to <username>/<server> where <server> is the name that you chose in the ZNC Networks list.