# ZNC

ZNC is an IRC network bouncer (BNC) that maintains a persistent connection to your chosen IRC servers so your nicknames, channels, and subscriptions stay active even when you are offline. It is open source and self-hosted, installable on Docker Hub, ZimaOS and Unraid.

Canonical page: https://ourlocalhost.com/app/534/znc

## Description

ZNC is an IRC network bouncer (BNC) that maintains a persistent connection to your chosen IRC servers so your nicknames, channels, and subscriptions stay active even when you are offline. Multiple clients in different locations can attach to the same ZNC account simultaneously and appear under one nickname. It is aimed at self-hosters and IRC users who want a reliable, always-on bridge between their client and the server.

## Platform availability

Available on 2 of 9 platforms: Unraid, ZimaOS.

## Health score

61/100 (Good), based on 3 of 4 factors.
- Maintained: 88 (last commit 27 days ago)
- Popular: 31 (33 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/linuxserver/znc
- ZimaOS: https://github.com/bigbeartechworld/big-bear-casaos/tree/master/Apps/znc
- Official website: http://wiki.znc.in/ZNC
- GitHub: https://github.com/linuxserver/docker-znc
- Unraid: https://ca.unraid.net/apps/znc-0pwx9l11vnawld?q=znc
- Documentation: http://wiki.znc.in/Git

## Common questions

### How do I generate the initial ZNC configuration?

Run znc --makeconf to create the initial configuration. After that, configure your IRC client to connect to your ZNC server.

### How do I tell an IRC client which IRC network to connect through ZNC?

Use the username format username@clientid/network in the client, or put username@clientid/network:password as the password if the client cannot send a username. The target network must already be configured.

### How do I add users or change settings after the initial setup?

You can add more users, tune existing ones, or change other settings through the ZNC web interface. You can also make changes from IRC.

### What happens if ZNC is configured to quit when I disconnect?

ZNC will stop running, so you must restart it on the host machine via physical access or SSH. Your client cannot connect to ZNC until it is running again.

### Are Git or nightly builds of ZNC stable enough to run?

Git versions are cutting edge, with bugfixes appearing early and larger features added after they have somewhat stabilized. They are usually very stable but may still contain unknown bugs.

### How should I handle SSL when reverse-proxying the ZNC IRC listener?

In the described Docker setup, SSL is disabled on the ZNC IRC listener and the reverse proxy passes the IRC connection to ZNC without SSL. The poster also allowed the IRC port in the firewall and forwarded it on the router.

## Alternatives

- Shout: The self-hosted web IRC client.
- jakeIRC
- jsIRC: jsIRC is written using Socket.IO, node.js, jQuery Title Alert and Sencha ExtJS, relying on string.js, Lo-Dash and PhantomJS.

---
Source: Our Local Host (https://ourlocalhost.com/app/534/znc), the self-hosted and open-source app directory.