NickServ

ACC

ACC returns parsable information about a user's login status. Note that on many networks, /whois shows similar information faster and more reliably. ACC also returns the unique entity ID of the given account. The answer is in the form <nick> [-> account] ACC <digit> <EID>, where <digit> is one of the following:
0 - account or user does not exist
1 - account exists but user is not logged in
2 - user is not logged in but recognized (see ACCESS)
3 - user is logged in

If the account is omitted the user's nick is used and the " -> account" portion of the reply is omitted. Account * means the account the user is logged in with.

Syntax: ACC
Syntax: ACC <nick>
Syntax: ACC <nick> <account>
Syntax: ACC <nick> *

Example:
/msg NickServ ACC jilles *

ACCESS

ACCESS maintains a list of user@host masks from where NickServ will recognize you, so it will not prompt you to change nick. Preventing expiry, getting channel access or editing nickname settings still requires identification, however.

Access list entries can use hostnames with optional wildcards, IP addresses and CIDR masks. There are restrictions on how much you can wildcard. If you omit the mask, NickServ will attempt to generate one matching your current connection.

Syntax: ACCESS LIST
Syntax: ACCESS ADD [mask]
Syntax: ACCESS DEL <mask>

Operators with user:auspex privilege can also view another user's access list.

Syntax: ACCESS LIST <nick>

Examples:
/msg NickServ ACCESS LIST
/msg NickServ ACCESS ADD jack@host.example.com
/msg NickServ ACCESS ADD user@10.0.0.8
/msg NickServ ACCESS ADD jilles@192.168.1.0/24
/msg NickServ ACCESS DEL *someone@*.area.old.example.net

BADMAIL

BADMAIL allows you to maintain a list of email addresses that are not allowed to be used to register accounts.

These email addresses are saved to the Atheme database and are kept between services restarts.

In BADMAIL ADD, you are able to use glob matching to disallow email addresses that match a pattern.

Syntax: BADMAIL ADD <email> [reason]

Examples:
/msg NickServ BADMAIL ADD jdhore1@gmail.com bar reason
/msg NickServ BADMAIL ADD *@aol.com bar reason
/msg NickServ BADMAIL ADD *@*.tk foo reason
/msg NickServ BADMAIL ADD some-spambot-pattern-*@gmail.com

BADMAIL DEL allows you to remove entries from the list of currently banned email addresses.

Syntax: BADMAIL DEL <email>

Examples:
/msg NickServ BADMAIL DEL foo@bar.com
/msg NickServ BADMAIL DEL *@aol.com

BADMAIL LIST allows you to list the currently banned email addresses.

Syntax: BADMAIL LIST

Examples:
/msg NickServ BADMAIL LIST

CERT

CERT maintains a list of CertFP fingerprints that will allow NickServ to recognize you and authenticate you automatically.

You cannot add the same fingerprint to multiple accounts.

CERT is agnostic with regard to the fingerprint format, which depends on the IRCd. If in question, use the CERT ADD command without any arguments, which will add the current fingerprint to the list, or ask network staff.

Syntax: CERT LIST
Syntax: CERT ADD [fingerprint]
Syntax: CERT DEL <fingerprint>
Syntax: CERT CLEAR

Operators with user:auspex privilege can also view another user's fingerprint list.

Syntax: CERT LIST <nick>

Examples:
/msg NickServ CERT LIST
/msg NickServ CERT ADD
/msg NickServ CERT ADD f3a1aad46ca88e180c25c9c7021a4b3a
/msg NickServ CERT DEL f3a1aad46ca88e180c25c9c7021a4b3a
/msg NickServ CERT CLEAR

DROP

Using this command makes NickServ remove your account and stop watching your nick(s), If a nick is dropped, anyone else can register it. You will also lose all your channel access and memos.

When dropping and re-registering an account during a netsplit, users on the other side of the split may later be recognized as the new account.

Syntax: DROP <nickname> <password>

Examples:
/msg NickServ DROP foo bar

FDROP

FDROP forcefully removes the given account, including all nicknames, channel access and memos attached to it.

When dropping and re-registering an account during a netsplit, users on the other side of the split may later be recognized as the new account.

Syntax: FDROP <nickname>

Examples:
/msg NickServ FDROP foo

FREEZE

FREEZE allows operators to "freeze" an abusive user's account. This logs out all sessions logged in to the account and prevents further logins. Thus, users cannot obtain the access associated with the account.

FREEZE information will be displayed in INFO output.

Syntax: FREEZE <nick> ON|OFF <reason>

Examples:
/msg NickServ FREEZE pfish ON Persistent spammer
/msg NickServ FREEZE alambert OFF

FUNGROUP

FUNGROUP forcefully unregisters the given nickname from the account it is registered to.

If you are ungrouping an account name, you need to specify a new name for the account. This must be another nick registered to it. You cannot ungroup account names.

Syntax: FUNGROUP <nickname>
Syntax: FUNGROUP <account> <newname>

Examples:
/msg NickServ FUNGROUP SomeNick
/msg NickServ FUNGROUP SomeName SomeNick

FVERIFY

FVERIFY allows administrators to confirm a change associated with an account registration without having the verification email.

Syntax: FVERIFY <operation> <nickname>

Example:
/msg NickServ FVERIFY REGISTER jenny
/msg NickServ FVERIFY EMAILCHG Aeriana

GHOST

GHOST disconnects an old user session, or somebody attempting to use your nickname without authorization.

If you are logged in to the nick's account, you need not specify a password, otherwise you have to.

Syntax: GHOST <nick> [password]

Example:
/msg NickServ GHOST foo bar

GROUP

GROUP registers your current nickname to your account. This means that NickServ protects this nickname the same way as it protects your account name. Most services commands will accept the new nickname as an alias for your account name.

Please note that grouped nicks expire separately from accounts. To prevent this, you must use them. Otherwise, all properties of the account are shared among all nicks registered to it.

Syntax: GROUP

Examples:
/msg NickServ IDENTIFY OldNick SecretPassword
/msg NickServ GROUP

HOLD

HOLD prevents an account and all nicknames registered to it from expiring.

Syntax: HOLD <nick> ON|OFF

Examples:
/msg NickServ HOLD jilles ON

IDENTIFY

IDENTIFY identifies you with services so that you can perform general maintenance and commands that require you to be logged in.

Syntax: IDENTIFY <password>

You can also identify for another nick than you are currently using.

Syntax: IDENTIFY <nick> <password>

Example:
/msg NickServ IDENTIFY foo
/msg NickServ IDENTIFY jilles foo

INFO

INFO displays account information such as registration time, flags, and other details. Additionally it will display registration and last seen time of the nick you give.

You can query the nick a user is logged in as by specifying an equals sign followed by their nick. This '=' convention works with most commands.

Syntax: INFO <nickname>
Syntax: INFO =<online user>

Examples:
/msg NickServ INFO w00t Shows information about the registered nick w00t.
/msg NickServ INFO =w00tie[home] Shows information about the registered nick the user w00tie[home] is logged in as.

LIST

LIST shows registered users that match the given criteria. Multiple criteria may be used in the same command.

Current criteria are: PATTERN - All users that match a given pattern. EMAIL - All accounts registered with an email address
that matches a given pattern. MARK-REASON - All accounts whose mark reason matches a
given pattern. FROZEN-REASON - All frozen accounts whose freeze reason matches
a given pattern. RESTRICTED-REASON - All restricted accounts whose restrict reason matches
a given pattern. HOLD - All users with the HOLD flag set. NOOP - All users with the NOOP flag set. NEVEROP - All users with the NEVEROP flag set. WAITAUTH - All users with the WAITAUTH flag set. HIDEMAIL - All users with the HIDEMAIL flag set. NOMEMO - All users with the NOMEMO flag set. EMAILMEMOS - All users with the EMAILMEMOS flag set. USE-PRIVMSG - All users with the USEPRIVMSG flag set. QUIETCHG - All users with the QUIETCHG flag set. NOGREET - All users with the NOGREET flag set. PRIVATE - All users with the PRIVATE flag set. NOPASSWORD - All users with the NOPASSWORD flag set. REGNOLIMIT - All users with the REGNOLIMIT flag set.

FROZEN - All users frozen by network staff. MARKED - All users marked by network staff. RESTRICTED - All users restricted by network staff. VACATION - All users marked as being on vacation. REGISTERED - User accounts registered longer ago than a given age. LASTLOGIN - User accounts last used longer ago than a given age.

Syntax: LIST <criteria>

Examples:
/msg NickServ LIST pattern foo*
/msg NickServ LIST hold
/msg NickServ LIST frozen pattern x*
/msg NickServ LIST registered 30d
/msg NickServ LIST marked registered 7d pattern bar
/msg NickServ LIST email *@gmail.com
/msg NickServ LIST mark-reason *lamer*

LISTCHANS

LISTCHANS shows the channels that you have access to, including those that you own.

AKICKs and host-based access are not shown.

Syntax: LISTCHANS

Operators with chan:auspex privilege can also check another user's access.

Syntax: LISTCHANS <nick>

Example:
/msg NickServ LISTCHANS

LISTGROUPS

LISTGROUPS shows the groups that you have access to, including those that you own.

Group BANs are not shown.

Syntax: LISTGROUPS

Operators with group:auspex privilege can also check another user's access.

Syntax: LISTGROUPS <nick>

Example:
/msg NickServ LISTGROUPS

LISTMAIL

LISTMAIL shows accounts registered to a given e-mail address. Wildcards are allowed.

Syntax: LISTMAIL <email>

Examples:
/msg NickServ LISTMAIL patrick@example.com
/msg NickServ LISTMAIL *@cam.ac.uk

LISTOWNMAIL

LISTOWNMAIL shows accounts registered to your account's e-mail address.

Syntax: LISTOWNMAIL

Examples:
/msg NickServ LISTOWNMAIL

LISTVHOST

LISTVHOST shows accounts which have a vHost set on them. If a pattern is given, only accounts with vHosts matching the pattern are shown.

Syntax: LISTVHOST [pattern]

Examples:
/msg NickServ LISTVHOST
/msg NickServ LISTVHOST *staff*

LOGIN

LOGIN identifies you with services so that you can perform general maintenance and commands that require you to be logged in.

Syntax: LOGIN <account> <password>

Example:
/msg NickServ LOGIN smith sesame

LOGOUT

LOGOUT logs you out of the account that you are currently logged into.

Syntax: LOGOUT

Example:
/msg NickServ LOGOUT

MARK

MARK allows operators to attach a note to an account. For example, an operator could mark the account of a spammer so that others know the user has previously been warned.

MARK information will be displayed in INFO output.

Syntax: MARK <nickname> ON|OFF <reason>

Examples:
/msg NickServ MARK game_boy ON Persistent spammer
/msg NickServ MARK nenolod OFF

MARK

MARK allows operators to attach notes to an account. For example, an operator could mark the account of a spammer so that others know the user has previously been warned.

Syntax: MARK <nickname> ADD <note>

Adds a mark to a nick. Marks will be shown on doing MARK <nick> LIST or using NickServ info.

Syntax: MARK <nickname> DEL <number>

Deletes the mark with the given number.

Syntax: MARK <nickname> LIST

Shows all marks for a nickname.

Syntax: MARK MIGRATE

Migrates ALL the marks from the old mark module to this one.

Examples:
/msg NickServ MARK tomaw ADD Doesn't actually exist
/msg NickServ MARK tomaw ADD You can add as many marks as you want
/msg NickServ MARK tomaw LIST
/msg NickServ MARK tomaw DEL 2

REGAIN

REGAIN regains access to your nickname from a user that is using your nick.

If you are logged in to the account associated with the nickname, you need not specify a password, otherwise you have to.

Syntax: REGAIN <nick> [password]

Example:
/msg NickServ REGAIN Dave2 goats

REGISTER

This will register your current nickname with NickServ. This will allow you to assert some form of identity on the network and to be added to access lists. Furthermore, NickServ will warn users using your nick without identifying and allow you to kill ghosts. The password is a case-sensitive password that you make up. Please write down or memorize your password! You will need it later to change settings.

You have to confirm the email address. To do this, follow the instructions in the message sent to the email address.

Syntax: REGISTER <password> <email-address>

Examples:
/msg NickServ REGISTER bar foo@bar.com

REGNOLIMIT

REGNOLIMIT allows a user to maintain an unlimited amount of channel registrations.

Syntax: REGNOLIMIT <user> ON|OFF

Examples:
/msg NickServ REGNOLIMIT nenolod ON

RELEASE

RELEASE removes an enforcer for your nick or changes the nick of a user that is using your nick.

Enforcers are created when someone uses your nick without identifying and prevent all use of it.

If you are logged in to the nick, you need not specify a password, otherwise you have to.

Syntax: RELEASE <nick> [password]

Example:
/msg NickServ RELEASE smith sesame

RESETPASS

RESETPASS sets a random password for the specified account.

Syntax: RESETPASS <nickname>

Examples:
/msg NickServ RESETPASS pfish

RESTRICT

RESTRICT allows operators to restrict what an account can and can not do. It will currently block a user from grouping nicks, changing account name, registering a channel, registering a group, requesting a vHost or taking an OFFERed vHost.

This is particularly useful if a user starts abusing these commands.

Syntax: RESTRICT <nickname> ON|OFF <reason>

Examples:
/msg NickServ RESTRICT game_boy ON Abusing vHost requests
/msg NickServ RESTRICT nenolod OFF

RETURN

RETURN resets the specified account password, sends it to the email address specified and changes account's email address to this address. Any current sessions logged in to the account are logged out.

Syntax: RETURN <nickname> <e-mail>

Examples:
/msg NickServ RETURN jdoe john@example.com

SENDPASS

SENDPASS emails the password for the specified nickname to the corresponding email address. SENDPASS emails a key to the email address corresponding to the specified nickname that can be used to set a new password using SETPASS.

Syntax: SENDPASS <nickname>

If the nickname is marked, you can override this using the FORCE keyword.

Syntax: SENDPASS <nickname> FORCE

If a key has been emailed but not yet used, you can clear it using the CLEAR keyword.

Syntax: SENDPASS <nickname> CLEAR

Examples:
/msg NickServ SENDPASS foo

SENDPASS

SENDPASS emails a key to the email address corresponding to the specified nickname that can be used to set a new password using SETPASS.

Syntax: SENDPASS <nickname>

If a key has been emailed but not yet used, you can clear it using the CLEAR keyword.

Syntax: SENDPASS <nickname> CLEAR

Examples:
/msg NickServ SENDPASS foo

SET ACCOUNTNAME

SET ACCOUNTNAME allows you to change your account name to any nick registered to your account. Your account name is used in various places as a name for you.

Syntax: SET ACCOUNTNAME <nick>

SET EMAIL

SET EMAIL changes the e-mail address associated with an account. The e-mail address is used for password retrieval.

You may be required to confirm the new e-mail address. To confirm the address, follow the instructions in the message sent to the new address.

Syntax: SET EMAIL <new address>

Example:
/msg NickServ SET EMAIL dan@example.com

SET EMAILMEMOS

This will forward memos sent to your account to the email address listed on your registration.

Syntax: SET EMAILMEMOS [ON|OFF]

Example:
/msg NickServ SET EMAILMEMOS ON

SET ENFORCE

SET ENFORCE allows you to enable more protection for all nicknames registered to your account.

This will automatically change the nick of someone who attempts to use it without identifying in time, and temporarily block its use, which can be removed at your discretion. See help on RELEASE.

Syntax: SET ENFORCE ON|OFF

SET ENFORCETIME

SET ENFORCETIME sets how long (in seconds) after someone attempts to use one of your nicks they will automatically have their nick changed.

This can be set to DEFAULT to return to the network default or a number value between 1-180 (seconds).

Syntax: SET ENFORCETIME TIME|DEFAULT

Example:
/msg NickServ SET ENFORCETIME DEFAULT
/msg NickServ SET ENFORCETIME 90
/msg NickServ SET ENFORCETIME 3

SET HIDEMAIL

SET HIDEMAIL prevents an account's e-mail address from being shown to other users.

Syntax: SET HIDEMAIL ON|OFF

Example:
/msg NickServ SET HIDEMAIL ON

SET LANGUAGE

SET LANGUAGE changes the language services uses to communicate with you.

Syntax: SET LANGUAGE <abbreviation>

Example:
/msg NickServ SET LANGUAGE en
/msg NickServ SET LANGUAGE ru

SET NEVERGROUP

SET NEVERGROUP prevents others from adding you to group access lists.

Syntax: SET NEVERGROUP ON|OFF

Example:
/msg NickServ SET NEVERGROUP ON

SET NEVEROP

SET NEVEROP prevents others from adding you to channel access lists.

Syntax: SET NEVEROP ON|OFF

Example:
/msg NickServ SET NEVEROP ON

SET NOGREET

This setting allows you to opt-out of channel greeting notices.

Syntax: SET NOGREET ON|OFF

Example:
/msg NickServ SET NOGREET ON

SET NOMEMO

This prevents people from being able to send you a memo. If you do not want to receive memos, you can just turn them off for your nick.

Syntax: SET NOMEMO ON|OFF

Example:
/msg NickServ SET NOMEMO ON

SET NOOP

SET NOOP prevents services from automatically opping you in channels you have access in. You can choose to op/voice yourself by using the OP and VOICE commands.

Syntax: SET NOOP ON|OFF

Example:
/msg NickServ SET NOOP ON

SET NOPASSWORD

SET NOPASSWORD prevents password-based authentication attempts except for XMLRPC/JSONRPC. You will need to be identified using a passwordless authentication mechanism to be able to use NickServ GHOST, RELEASE and REGAIN.

Syntax: SET NOPASSWORD ON|OFF

Example:
/msg NickServ SET NOPASSWORD ON

SET PASSWORD

SET PASSWORD changes the password of an account.

Syntax: SET PASSWORD <new password>

Example:
/msg NickServ SET PASSWORD swordfish

SET PRIVATE

SET PRIVATE hides various information about your account from other users.

SET PRIVATE ON automatically enables HIDEMAIL too.

Syntax: SET PRIVATE ON|OFF

Example:
/msg NickServ SET PRIVATE ON

SET PRIVMSG

SET PRIVMSG causes Services to use private messages when talking to the user authenticated on this account.

Syntax: SET PRIVMSG ON|OFF

Example:
/msg NickServ SET PRIVMSG ON

SET PROPERTY

SET PROPERTY manipulates metadata associated with an account.

To delete a metadata entry, specify the name and leave the value blank.

Syntax: SET PROPERTY <name> [value]

Example:
/msg NickServ SET PROPERTY URL http://www.example.com/~jay/
/msg NickServ SET PROPERTY SIGN Pisces
/msg NickServ SET PROPERTY ICQ

SET PUBKEY

SET PUBKEY allows you to change your public key used for SASL ECDSA-NIST256p-CHALLENGE authentication. If no pubkey is given, your public key will be removed from the services database.

Syntax: SET PUBKEY [<pubkey>]

SET QUIETCHG

SET QUIETCHG prevents services from automatically notifying you when ChanServ is used to affect your status in channels. When set to ON, Services will no longer send you messages of this nature.

Syntax: SET QUIETCHG ON|OFF

Example:
/msg NickServ SET QUIETCHG ON

SETPASS

SETPASS allows you to set a new password using a key emailed to you. The key is valid for one time only, and also becomes invalid if you identify with your old password.

This command should only be used after you have already recieved an email with the key.

To set a new password if you know the current password, use SET PASSWORD instead of SETPASS.

Syntax: SETPASS <nickname> <key> <password>

STATUS

STATUS returns information about your current state. It will show information about your nickname, IRC operator, and SRA status.

Syntax: STATUS

Example:
/msg NickServ STATUS

TAXONOMY

The taxonomy command lists metadata information associated with registered users.

Examples:
/msg NickServ TAXONOMY foo

UNGROUP

UNGROUP unregisters the given nickname from your account. The nickname will be available for others to register. This will not affect your channel access or memos.

If you do not specify a nickname, your current nickname will be ungrouped. You cannot ungroup your account name.

Syntax: UNGROUP [nickname]

Examples:
/msg NickServ UNGROUP SomeNick

VACATION

VACATION extends the expiration time for your account and nicknames (but not your channels) to three times the usual value. You can only do this if your account is registered long enough.

Vacation mode is disabled automatically the next time you identify to NickServ.

Syntax: VACATION

Examples:
/msg NickServ VACATION

VERIFY

VERIFY confirms a change associated with your account registration.

Syntax: VERIFY <operation> <nickname> <key>

Example:
/msg NickServ VERIFY REGISTER jenny 161803399
/msg NickServ VERIFY EMAILCHG Aeriana 271828183

VHOST

VHOST allows operators to set a virtual host (also known as a spoof or cloak) on an account. This vHost will be set on the user immediately and each time they identify.

Syntax: VHOST <nickname> ON <vHost>
Syntax: VHOST <nickname> OFF

If the nickname is marked, you can override this using the FORCE keyword.

Syntax: VHOST <nickname> ON <vHost> FORCE
Syntax: VHOST <nickname> OFF FORCE

Examples:
/msg NickServ VHOST spb ON may.explode.on.impact
/msg NickServ VHOST nenolod OFF