Skip to content
Klutch.sh Docs

Deploying ZNC

Introduction

ZNC is an advanced IRC bouncer that stays connected to IRC networks 24/7 while you connect and disconnect from it. It keeps you logged in to IRC channels, stores messages while you’re away, and provides them when you reconnect. ZNC supports multiple networks, users, and extensive customization through modules.

Key highlights of ZNC:

  • Always Connected: Stay connected to IRC 24/7
  • Message Playback: Receive messages sent while you were away
  • Multiple Networks: Connect to multiple IRC networks simultaneously
  • Multi-User: Support multiple users on a single bouncer
  • Web Interface: Configure ZNC through a browser
  • Module System: Extend functionality with built-in and third-party modules
  • SSL Support: Secure connections to IRC networks
  • IPv6 Support: Full IPv6 compatibility

This guide walks through deploying ZNC on Klutch.sh using Docker.

Why Deploy ZNC on Klutch.sh

Deploying ZNC on Klutch.sh provides several advantages:

Always Online: Your IRC presence remains active 24/7.

Message History: Never miss messages sent while you’re offline.

HTTPS by Default: Secure web interface access with automatic SSL.

Persistent Storage: Your configuration and logs persist with Klutch.sh volumes.

Prerequisites

Before deploying ZNC on Klutch.sh, ensure you have:

Deploying ZNC on Klutch.sh

    Create Your Repository

    Create a new GitHub repository with a Dockerfile:

    FROM znc:latest
    

    # Create data directory
    RUN mkdir -p /znc-data
    

    ENV ZNC_PORT=6697
    

    VOLUME ["/znc-data"]
    

    EXPOSE 6697
    

    CMD ["--foreground"]

    Push to GitHub

    Push your Dockerfile to your GitHub repository.

    Create a New Project on Klutch.sh

    Navigate to the Klutch.sh dashboard and create a new project.

    Create a New App

    Within your project, create a new app and connect your GitHub repository.

    Configure HTTP Traffic

    Set the traffic type to HTTP with port 6697 (ZNC’s web interface).

    Attach Persistent Volume

    Add a persistent volume mounted at /znc-data for your configuration and logs.

    Deploy Your Application

    Click Deploy to build and launch ZNC.

    Initial Configuration

    On first run, access your ZNC instance and complete the web-based setup wizard to:

    • Create an admin user
    • Configure IRC networks
    • Set up channels to join

    Connect Your IRC Client

    Configure your IRC client to connect to your ZNC instance instead of directly to IRC networks.

Additional Resources

Conclusion

ZNC on Klutch.sh keeps you connected to IRC networks around the clock. Never miss important messages or conversations, and connect from any device while maintaining a consistent IRC presence.