Troubleshooting
Deep help for common connection errors, TLS problems, channel bans, hostmask issues, disabled channels, timeouts, and IRC network-side policy problems.
Back to SupportArticles
Certificate fingerprint warnings
Explains why ZNC may ask you to trust a certificate fingerprint and when not to continue.
100 viewsWhat “address is banned” means
Explains channel/network ban masks, vhosts, ident, and why a BNC can be rejected even when it is working.
96 viewsWhat a channel ban mask is
Explains IRC ban masks and how nick, ident, host, vhost, and broad masks affect joins.
85 viewsWhy some channels reject BNC or VPS users
Explains why some channels or networks reject hosted users, public BNCs, VPS ranges, or broad hostmasks.
75 viewsWhat ~ident means
Explains why IRC sometimes shows ~ before ident and how that can affect channel bans.
103 viewsWhat “Connection refused” means
Common causes of connection refused when Eggy BNC tries to connect to a remote IRC network.
83 viewsWhat “IRC connection timed out” means
Explains IRC network timeouts and how to separate remote network problems from Eggy BNC connection problems.
88 viewsWhat “Software caused connection abort” means
Explains common causes of software-caused connection aborts, especially wrong SSL/TLS settings.
83 viewsWhy /list may not show channels
Explains why IRC /list can be slow, filtered, hidden by clients, throttled, or blocked by networks.
53 viewsWhy ZNC says a channel could not be joined and disabled it
Explains why ZNC disables saved channels after repeated join failures and how to recover safely.
38 viewsHow to remove a broken saved channel
Shows how to list and remove a saved ZNC channel that keeps failing to join.
63 viewsHow to reconnect or jump servers
Useful ways to reconnect one ZNC network without restarting the whole BNC service.
96 views