Enable Colloquy Push with ZNC

Colloquy push allows you to recieve IRC messages/highlights from ZNC to your iPhone, iPod Touch, or iPad via the native "push" feature built into iOS.

Setup the colloquy module in ZNC

If you do not already have the module enabled on ZNC, download and install it:

curl -LO http://icj.me/dl/colloquy.cpp
znc-buildmod colloquy.cpp
mv colloquy.so .znc/modules/

In your irc client, do:

/znc loadmod colloquy

Once you have the module loaded, you can then use /msg *colloquy help for a list of options.

Setup on the iOS device

  1. Open the Colloquy app, and tap the [ + ] button in the top left hand corner.
  2. Select "IRC Connection".
  3. Enter the server name of your BNC in the "Address" box.
  4. Important: Click the "Push Notifications" button, and turn them ON.
  5. Ignore the "Network Identity" and "Automatic Actions" sections, unless you want to change them.


  6. Click the "Advanced" button
  7. Change the server port to the one that your server uses. Toggle the SSL button if neccessary.
  8. In the "Authentication" section, do the following:
    • Put your ZNC username in the "Username" box.
    • Put your ZNC password in the "Password" box.
    • Ignore the "Nick Pass" section.


  9. Click the button at the top left of the page to go back to the main section.
  10. Close the colloquy app.
  11. Reopen the Colloquy app, you should be prompted with a "Colloquy would like to send you Push Notifications" alert. Click OK.
  12. Click the [ Connect ] button.
  13. Then go back to your IRC client, and do the following:
    /msg *colloquy list
  14. You should see your iOS device's name in the list, along with options configured.
  15. You can then go into the Settings app on your iOS device, and configure keywords to highlight, etc.

For more info, visit the colloquy page or the ZNC wiki.