Example configuration

Configuration files normally live in /etc/uhub/ on Unix systems.

uhub.conf

The main configuration file.

plugins.conf

The plug-in configuration file, referenced from file_plugins.

users.conf

The ACL file (bans and denied nicks), referenced from file_acl.

uhub.conf

hub_name = My Public Hub
hub_description = Yet another ADC hub

server_port = 12345
server_bind_addr = any
max_users = 150

file_plugins = /etc/uhub/plugins.conf
file_acl = /etc/uhub/users.conf

plugins.conf

plugin /var/lib/uhub/mod_auth_sqlite.so "file=/etc/uhub/users.db"
plugin /var/lib/uhub/mod_logging.so "file=/var/log/uhub/uhub.log"
plugin /var/lib/uhub/mod_welcome.so "motd=/etc/uhub/motd.txt rules=/etc/uhub/rules.txt"
plugin /var/lib/uhub/mod_chat_history.so "history_max=200 history_default=10 history_connect=5"

users.conf

The ACL file holds ban and deny rules. Since 0.8.0 it no longer holds accounts — those live in an authentication plug-in such as mod_auth_sqlite.

deny_nick Hub-Security
ban_nick spammer
ban_cid FOIL5EK2UDZYAXT7UIUFEKL4SEBEAJE3INJDKAY
deny_ip 192.168.0.0/24

See the configuration reference for every available directive, and the plug-ins page for details on each module.