Operators
What is an IRC Operator?
Section titled “What is an IRC Operator?”An IRC operator (IRC op or IRCop) is a user with elevated server-level privileges. Operators can manage the entire server, not just a single channel.
Operators are not the same as channel operators. Channel operators (+o in a channel) only have privileges within that channel.
Becoming an Operator
Section titled “Becoming an Operator”To become an IRC operator, you need:
- A configured operator credential in
elixircd.exs(see Operators Configuration) - Run the OPER command after connecting
/oper admin yourpasswordIf successful, you receive the +o user mode and a message like:
You are now an IRC OperatorOperator Modes
Section titled “Operator Modes”When you become an operator, you receive the +o mode. You can also set additional operator-only modes:
| Mode | Description |
|---|---|
+o | IRC Operator status — server-managed, cannot be self-set |
+H | Hide Operator — hides your IRC op status in WHOIS from non-operators |
+s | Server Notices — receive server notice messages (snomask) |
Setting +H makes you appear as a regular user in WHOIS responses to non-operators. Operators can still see your op status.
When you remove +o (de-oper), all operator-only modes (+H, +s) are automatically removed as well.
Operator Privileges
Section titled “Operator Privileges”IRC operators can use special commands:
| Command | What it does |
|---|---|
KILL <nick> <reason> | Forcefully disconnect a user from the server |
OPERWALL <message> | Send a message to all operators |
GLOBOPS <message> | Send a global operator message to all operators |
WALLOPS <message> | Broadcast a message to all users with +w mode |
REHASH | Reload the server configuration |
RESTART | Restart the server |
DIE | Shut down the server |
STATS <letter> | View server statistics |
TRACE | Trace routes to users/servers |
CHGHOST <user> <newhost> | Change a user’s hostname |
Additionally, operators:
- Can join channels with
+O(Oper Only) mode - Bypass
+j(Join Throttle) restrictions - Can set the
+Ochannel mode (Oper Only) - Can view hidden information in WHOIS that non-operators cannot see
WALLOPS and OPERWALL
Section titled “WALLOPS and OPERWALL”- WALLOPS (
/wallops message) — sends a broadcast to all users with the+w(Wallops) user mode. Regular users can enable+wto receive these messages. - OPERWALL (
/operwall message) — sends a message only to operators. Regular users cannot see it. - GLOBOPS (
/globops message) — sends a global message to all operators.
De-Opering
Section titled “De-Opering”To relinquish operator status:
/mode yournick -oThis removes +o and automatically removes any operator-only modes (+H, +s).
Operator Configuration
Section titled “Operator Configuration”Operator credentials are stored in elixircd.exs:
operators: [ {"admin", "$argon2id$v=19$m=4096,t=2,p=4$...hash..."}]The password is hashed with Argon2id. To generate a hash:
# In iex or via docker execArgon2.hash_pwd_salt("your_password_here")See IRC Operators Configuration for full details.