Updating a network's settings

Network settings control how the IRC Driven crawler indexes your network, how the channel bot behaves, and how the embedded web chat connects. This guide walks through each section.

Prerequisites

• You must be logged in and have network admin access. See the guide on gaining access if needed.

Where to find it

From your network's page, click Network Admin in the navigation, then Network Settings. The form is organized into three columns: Channel Bot Settings, Extra Options, and Index & /LIST.

Channel Bot Settings

Configure the IRC Driven channel bot that joins channels on your network and provides logging, commands, URL expansion, and more.

• Bot Nickname — The nickname the bot uses when connecting. Leave blank to use the default.
• Support NickServ — Enable if the bot should identify to NickServ. Use when your network requires registered nicks for bots.
• NickServ Identify Command — Choose IDENTIFY or AUTH depending on your network's services.
• NickServ Username — The account name the bot identifies with.
• NickServ Password — The password for NickServ identification. Stored in plain text; do not use a sensitive password.

An IRC Daemon Configuration section shows example rate-limit exemptions for common IRCds (UnrealIRCd, InspIRCd, hybrid, etc.). Exempting crawler.ircdriven.com from flood limits ensures reliable indexing.

Extra Options

Options that affect how the crawler indexes and how the embedded Kiwi IRC web chat connects.

• Support /LINKS — Enable if regular users can run /LINKS on your network. Helps the crawler discover servers.
• Support Remote — Enable if your network supports remote commands so the crawler can index servers it did not connect to directly.
• Support SSL (Globally) — Enable if all servers support SSL (typically port 6697).
• Require SSL — Enable only if clients must use TLS to connect. Affects the embedded web chat.
• Use ALIS for channel list — Enable if your network uses ALIS for channel discovery and /LIST does not return all channels. Set ALIS channels per page (64 or 128) to match your network.

WebIRC / Live Chat

Controls how the embedded Kiwi IRC web client connects to your network.

• Use custom WebSocket — Enable if your network provides an IRCv3 WebSocket or its own WebIRC WebSocket endpoint. Users connect directly to your WebSocket instead of the IRC Driven gateway.
• WebSocket URI — Full WebSocket URL (e.g. wss://irc.example.com:6697). Required when using a custom WebSocket.
• WebIRC Password (gateway mode) — When using the IRC Driven gateway (not a custom WebSocket), enter the WebIRC password from your network so web users' hostnames display correctly.

See the Setting Up WebSocket Connections for Live Chat tutorial for details.

Index & /LIST

• Index interval — How often the crawler runs a full index of the network (1, 2, 4, 6, 8, or 16 hours). More frequent indexing keeps stats up to date but uses more resources.
• /LIST delay (seconds) — If your network requires a delay before /LIST, select it here. You can avoid this by exempting crawler.ircdriven.com from rate limits.

Saving

Click Save Changes at the bottom of the form. Changes are applied immediately. The channel bot receives a config update and will use the new settings on its next connect or rejoin.

Related

• Live Channel Bot — What the bot does and what features it provides.
• Setting Up WebSocket Connections for Live Chat — Gateway vs direct WebSocket for the embedded Kiwi IRC client.