Fizi: Protected "DWShells:ZNC" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)) [cascading]

2026-10-05T20:21:58Z

Protected "DWShells:ZNC" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)) [cascading]

← Older revision		Revision as of 01:21, 6 October 2026
(No difference)

Fizi: Created page with "'''Set up and connect to ZNC''' Create a managed bouncer, connect your IRC client and understand the two network connections. '''Last verified:''' 6 October 2026, against the current customer panel and service rules. Your effective dashboard permissions and assigned values take precedence over examples. ← Documentation hub · [https://shells.darkworld.network/guides/znc/ Visual website guide] == ZNC has tw..."

2026-10-05T20:21:41Z

Created page with "'''Set up and connect to ZNC''' Create a managed bouncer, connect your IRC client and understand the two network connections. '''Last verified:''' 6 October 2026, against the current customer panel and service rules. Your effective dashboard permissions and assigned values take precedence over examples. ← Documentation hub · [https://shells.darkworld.network/guides/znc/ Visual website guide] == ZNC has tw..."

New page

'''Set up and connect to ZNC'''

Create a managed bouncer, connect your IRC client and understand the two network connections.

'''Last verified:''' 6 October 2026, against the current customer panel and service rules. Your effective dashboard permissions and assigned values take precedence over examples.

[[DWShells:Documentation|← Documentation hub]] · [https://shells.darkworld.network/guides/znc/ Visual website guide]

== ZNC has two separate connections ==
{| class="wikitable"
!Step
!What it means
|-
|01 · Your IRC client
|Connects inbound using ZNC login and assigned listener port.
|-
|02 · Your ZNC
|Runs on the shell and keeps its network session.
|-
|03 · IRC network
|Receives the outbound connection on its server port.
|}

== Check permissions and ports ==
'''Before you continue:''' Open Packages for the selected active shell. ZNC must be permitted and an assigned listener port must be available. If your allocation has only one listener port, ZNC and Eggdrop cannot both reserve it. Do not copy a port from another user.

== Create a managed instance ==

# '''Open the ZNC manager.''' In Packages, choose ZNC. If an existing instance is already configured, inspect its details instead of running setup again.
# '''Enter the ZNC identity.''' Choose the ZNC username, IRC nickname and a separate ZNC password of at least 14 characters. Confirm the password.
# '''Choose the IRC network.''' Enter a network name and a permitted IRC server. DarkWorld community connections use irc.darkworld.chat with TLS on 6697. Keep Use TLS to IRC server enabled for that connection. Other networks must meet shell network policy.
# '''Set up and start.''' Use Set up and start ZNC. The portal chooses an available assigned listener port. Wait for the result, then check status and View logs.

== Connect your IRC client ==
Use the Client connection details shown by the manager: hostname/address, listener port, TLS setting and login. The displayed login can include the network, such as ZNC_USERNAME/NETWORK_NAME. Use the ZNC password, not the shell or dashboard password.
{| class="wikitable"
!What you see
!What to do
|-
|Client → ZNC
|Your assigned application listener port, shown in Packages. Use the displayed SSL/TLS setting.
|-
|ZNC → IRC network
|The network server’s port, for example TLS 6697. This is not your allocated listener port.
|-
|IPv4 inbound
|Use only a connection marked IPv4 forwarding confirmed. Otherwise follow the IPv6 details or contact staff.
|-
|Free outbound
|IRC connections use assigned IPv6. IPv4 access from your client does not change that policy.
|-
|Other plans outbound
|Managed configuration prefers assigned IPv6 with permitted IPv4 fallback.
|}

== TLS and the web interface ==
Match the displayed hostname to the certificate. Verify a fingerprint when the portal supplies one; do not disable certificate verification to hide a warning. Use Open ZNC web only when the manager shows it. “Web Access is not enabled” means the web interface is not available, not necessarily that the IRC listener is down.

== Manage or replace ZNC ==
Use Start, Stop, Restart and View logs. Install fresh and Delete ZNC are destructive: stop first and make an independent copy of needed settings. The confirmation removes configuration, credentials, logs and scripts. Install fresh reopens setup; it is not a repair that preserves your existing account.

== Troubleshooting ==
{| class="wikitable"
!What you see
!What to do
|-
|Client cannot connect
|Check assigned listener port, TLS and forwarding status, then the running state and logs.
|-
|Client connects, network is offline
|Check IRC server, server port, TLS, permitted destinations and IPv6 support on Free.
|-
|Login rejected
|Use the displayed ZNC login and ZNC password. Network names matter.
|-
|No available port
|Review existing app reservations and your allocation; ask staff before changing ports.
|}

== Client connection checklist ==

# Open the selected shell's ZNC manager and confirm it is running.
# Copy the displayed hostname or address and allocated listener port.
# Match the displayed client TLS setting.
# Use the displayed ZNC login, including <code>/NETWORK_NAME</code> when present.
# Enter the separate ZNC password in your IRC client's appropriate credential field.
# Inspect the ZNC network connection after the client has authenticated.

For irssi, the panel provides '''Copy irssi command''' and, when forwarding is confirmed, '''Copy IPv4 command'''. Read the generated command, replace its password placeholder locally, and verify the displayed certificate information. Do not post the completed command in a public channel or support ticket.

== Recover without unnecessary reinstallation ==
Start with running state and logs. Restart only when appropriate. An inbound connection problem is different from an offline IRC network connection. Installing fresh destroys the selected configuration and credentials; use it only when you intentionally want a new setup and have copied what you need.

== Rules and support ==
This guide describes how to use the service; it does not replace [[DWShells:Signup and Rules|Signup and Rules]]. Join '''#DWShells''' on <code>irc.darkworld.chat</code> using TLS port '''6697''' for help. Use [https://panel.shells.darkworld.network/customer/ the customer portal] for your actual status and connection details. Never share credentials or recovery links.

[[DWShells:Documentation|Back to documentation]]

DWShells:ZNC - Revision history

Fizi: Protected "DWShells:ZNC" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)) [cascading]