Skip to main content

/server add

/server add <name> <address> [port] [options]
Add a network to your configuration. Options:
FlagDescription
-tlsEnable TLS encryption
-notlsDisable TLS (plain TCP)
-autoconnectConnect automatically on startup
-username <user>IRC username (appears in hostmask)
-password <pass>Server password (IRC PASS command)
-nick <nick>Override default nick for this network
Examples:
# Basic
/server add libera irc.libera.chat 6697 -tls -autoconnect

# With credentials (using vault secret)
/server add libera irc.libera.chat 6697 -tls -autoconnect -username mynick -password ${libera_pass}

# Plain TCP, no TLS
/server add efnet irc.efnet.org 6667 -notls

# With custom nick
/server add testnet irc.test.com 6697 -tls -nick testbot
The -password flag sets the IRC PASS command (sent on connect). Use ${secret_name} to reference vault secrets. For SASL or NickServ auth, use /server set after adding.

/server remove

/server remove <name>
Remove a network from configuration.

/server list

/server list
List all configured networks.

/server set

/server set <name> <key> <value>
Set a field on a network. Available fields:
KeyExampleDescription
addressirc.libera.chatServer hostname
port6697Port number
tlstrueTLS on/off
password${server_pass}Server password (PASS command)
usernamemyuserIRC username (hostmask)
nickmynickNick override
auth_methodsaslsasl, nickserv, or none
sasl_usernamemynickSASL username
sasl_password${libera_pass}SASL password
nickserv_password${libera_pass}NickServ password
autojoin#rust, #flumeChannels to join
autoconnecttrueAuto-connect on startup
bouncerzncznc, soju, or none

Authentication Examples

SASL (recommended for Libera Chat):
/secure set libera_pass my-password
/server set libera auth_method sasl
/server set libera sasl_username mynick
/server set libera sasl_password ${libera_pass}
NickServ:
/server set libera auth_method nickserv
/server set libera nickserv_password ${libera_pass}
Server password (PASS command):
/server set myserver password ${server_pass}
All password fields support ${secret_name} vault references.

/connect

/connect <name>
Connect to a configured network.

/disconnect

/disconnect
Disconnect the active server.

/save

/save
Saves both configuration files:
  • ~/.config/flume/irc.toml — network configurations
  • ~/.config/flume/config.toml — UI settings (theme, show_join_part, etc.)
Runtime changes made via /set and /theme are persisted by /save.