[ NickServ Commands ]

Browse by command: help, register, identify, drop, link, unlink, listlinks, access, set, unset, recover, release, ghost, info, listchans, status, set password, set language, set url, setemail, set info, set kill, set secure, set private, set hide, set timezone, set mainnick

NickServ allows you to "register" a nickname and prevent others from using it. NickServ is controlled through various commands which allow for registration and maintenance of nicknames. For a list of commands, type /msg NickServ HELP COMMANDS; to use a command, type /msg NickServ command, and for more information on a specific command, type /msg NickServ HELP command.

If a registered nickname is not used for 30 days, the registration will expire and the nickname will be available for anyone to use.

help commands
The following commands can be used with NickServ:

REGISTER - Register a nickname
IDENTIFY - Identify yourself with your password
DROP - Cancel the registration of a nickname
LINK - Link another nickname to your own
UNLINK - Cancel a linked nickname
LISTLINKS - List all nicknames you have linked
ACCESS - Modify the list of authorized addresses
SET - Set options, including kill protection
UNSET - Clear nickname information
RECOVER - Kill another user who has taken your nickname
RELEASE - Regain custody of your nickname after RECOVER
GHOST - Disconnect a "ghost" session
INFO - Display information on a nickname
LISTCHANS - List all channels you own
STATUS - Check whether a given nickname is identified

help register
Syntax: REGISTER password email

Registers your nickname in the NickServ database. Once your nickname is registered, you can use the SET and ACCESS commands to configure your nickname's settings as you like them. Make sure you remember the password you use when registering; you'll need it to make changes to your nickname later. (Note that case matters! FIDO, Fido, and fido are all different passwords!)

You must include an E-mail address when registering your nickname. You can prevent your E-mail address from being shown to other users with the SET HIDE command (type /msg NickServ HELP SET HIDE for more information).

Guidelines on choosing passwords:

Passwords should not be easily guessable. For example, using your real name as a password is a bad idea. Using your nickname as a password is a much worse idea and, in fact, NickServ will not allow it. Also, short passwords are vulnerable to trial-and-error searches, so you should choose a password at least 5 characters long.

help identify
Syntax: IDENTIFY password

Tells NickServ that you are really the owner of this nickname. Many commands require you to authenticate yourself with this command before you use them. The password should be the same one you sent with the REGISTER command.

help drop
Syntax: DROP password

De-registers (drops) your nickname from the NickServ database. A nickname that has been dropped is free for anyone to re-register.

Note that when you drop a nickname, all nicknames linked to it will be dropped as well. To remove a single linked nickname, use the UNLINK command.

To prevent accidental use of this command, you must enter your password in order to drop your nickname.

help link
Syntax: LINK nickname

Links a new nickname to the nickname you are currently using, creating a new "alias" for your nickname. The new nickname will be equivalent to your current nickname in terms of access privileges and memos; for example, you can read memos sent to one of your linked nicks from any other one, and if one of your nicks has auto-op privileges in a channel, you will get auto-opped no matter which linked nick you use.

To cancel a link, use the UNLINK command.

In order to use this command, you must identify for your current nickname (using the IDENTIFY command), and the nickname to be linked must not currently be in use.

help unlink
Syntax: UNLINK nickname

Removes a link (alias) to your nickname created with the LINK command. You cannot unlink the nickname you are currently using; change to another linked nick first before using this command.

If you unlink the "main nickname" you have selected using the SET MAINNICK command, your current nickname will automatically be selected as the main nickname.

help listlinks

Lists all nicknames which are linked to your nick. The main nickname for the group of linked nicks will be indicated by a "*" to the left of the nick.

help access
Syntax: ACCESS ADD mask

Modifies or displays the access list for your nickname. This is the list of user@host addresses which will be automatically recognized by NickServ as being allowed to use the nickname. If you connect to IRC with an address on this list, you will not be affected by the nick's SET KILL setting, and if the SECURE option is disabled, you will be able to receive auto-op and other privileges in channels without using the IDENTIFY command.

The mask given to the ADD and DEL commands may contain wildcards (* or ?).


ACCESS ADD achurch@*
Allows access to user achurch from any machine in the domain.

ACCESS DEL achurch@*
Reverses the previous command.

Displays the current access list.

help set
Syntax: SET option parameters

Sets various nickname options. option can be one of:

PASSWORD - Set your nickname password
LANGUAGE - Set the language Services will use when sending messages to you
URL - Associate a URL with your nickname
EMAIL - Associate an E-mail address with your nickname
INFO - Set text to be shown with the INFO command
KILL - Turn kill protection on or off
SECURE - Turn nickname security on or off
PRIVATE - Prevent your nickname from appearing in a /msg NickServ LIST
HIDE - Hide certain pieces of nickname information
TIMEZONE - Set the time zone to use for displaying times
MAINNICK - Set the nickname shown in channel access lists

In order to use this command, you must first identify with your password (/msg NickServ HELP IDENTIFY for more information).

Type /msg NickServ HELP SET option for more information on a specific option.

help unset
Syntax: UNSET {URL | INFO}

Allows you to clear the URL (URL) or information text (INFO) associated with your nickname.

help recover
Syntax: RECOVER nickname [password]

Allows you to recover your nickname if someone else has taken it; this does the same thing that NickServ does automatically if someone tries to use a kill-protected nickname.

When you give this command, NickServ will bring a fake user online with the same nickname as the user you're trying to recover your nick from, causing the IRC servers to disconnect the other user. This fake user will remain online for one minute to ensure that the other user does not immediately reconnect; after that minute, you can reclaim your nick. Alternatively, use the RELEASE command (/msg NickServ HELP RELEASE) to get the nick back sooner.

In order to use the RECOVER command for a nickname, you must supply the correct password for the nickname, or you must already have identified to a nick linked to the given nick.

help release
Syntax: RELEASE nickname [password]

Instructs NickServ to remove any hold on your nickname caused by automatic kill protection or use of the RECOVER command. By default, such holds last for one minute; this command gets rid of them sooner.

In order to use the RELEASE command for a nickname, you must supply the correct password for the nickname, or you must already have identified to a nick linked to the given nick.

help ghost
Syntax: GHOST nickname [password]

Terminates a "ghost" IRC session using your nickname. A "ghost" session is one which is not actually connected, but which the IRC server believes is still online for one reason or another. Typically, this happens if your computer crashes or your Internet or modem connection goes down while you're on IRC.

In order to use the GHOST command for a nickname, you must supply the correct password for the nickname, or you must already have identified to a nick linked to the given nick.

help info
Syntax: INFO nickname [ALL]

Displays information about the given nickname, such as the nickname's owner, last seen address and time, and options. If you are identified for the nick you're getting information for and ALL is specified, you will be shown all the information, regardless of whether it's hidden or not.

help listchans

Lists the names and the total number of channels you have registered under your nickname.

help status
Syntax: STATUS nickname...

Returns whether the user using the given nickname is recognized as the owner of the nickname. The response has this format:

nickname status-code

where nickname is the nickname sent with the command, and status-code is one of the following:

0 - no such user online or nickname not registered
1 - user not recognized as nickname's owner
2 - user recognized as owner via access list only
3 - user recognized as owner via password identification

Up to sixteen nicknames may be sent with each command; the rest will be ignored. No error message is generated if no nickname is given.

help set password
Syntax: SET PASSWORD new-password

Changes the password used to identify you as the nickname's owner.

help set language
Syntax: SET LANGUAGE number

Changes the language Services uses when sending messages to you (for example, when responding to a command you send). number should be chosen from the following list of supported languages:
1) English
2) Nederlands (Dutch)
3) Franšais (French)
4) Deutsch (German)
5) Magyar (Hungarian)
6) Italian
7) (Japanese / EUC encoding)
8) (Japanese / SJIS encoding)
9) Portugues (Portuguese)
10) Espa˝ol (Spanish)
11) Turkce (Turkish)

help set url
Syntax: SET URL url

Associates the given URL with your nickname. This URL will be displayed whenever someone requests information on your nickname with the INFO command.

help set email
Syntax: SET EMAIL address

Associates the given E-mail address with your nickname. This address will be displayed whenever someone requests information on your nickname with the INFO command.

help set info
Syntax: SET INFO text

Associates the given text with your nickname; it will be displayed whenever someone requests information on your nickname with the INFO command.

help set kill

Turns the automatic kill protection option for your nickname on or off. With kill protection on, if another user tries to take your nick, they will be given one minute to change to another nick, after which they will be forcibly removed from IRC by NickServ.

If you select QUICK, the user will be given only 20 seconds to change their nickname instead of the usual 60. If you select IMMED, the user will be killed immediately without being warned first or given a chance to change their nick; please do not use this option unless necessary. Also, your network's administrators may have disabled this option.

help set secure

Turns NickServ's security features on or off for your nickname. With SECURE set, you must enter your password before you will be recognized as the owner of the nick, regardless of whether your address is on the access list. However, if you are on the access list, NickServ will not auto-kill you regardless of the setting of the KILL option.

help set private

Turns NickServ's privacy option on or off for your nickname. With PRIVATE set, your nickname will not appear in nickname lists generated with NickServ's LIST command. (However, anyone who knows your nickname can still get information on it using the INFO command.)

help set hide

Allows you to prevent certain pieces of information from being displayed when someone does a NickServ INFO on your nickname. You can hide your E-mail address (EMAIL), last seen user@host mask (USERMASK), and last quit message (QUIT). The second parameter specifies whether the information should be displayed (OFF) or hidden (ON).

help set timezone
Syntax: SET TIMEZONE {UTC-offset | time-zone | DEFAULT}

Sets the time zone to use for displaying times (such as a nickname or channel's last used time), instead of using the time zone Services is operating in; the DEFAULT setting can be used to return to Services' time zone. The time zone can be specified in one of two ways:

- As a UTC offset, the time difference between your local time and UTC (Universal Coordinated Time, also known as GMT, Greenwich Mean Time). The offset is given as a "+" or "-" to indicate ahead of (east) or behind (west) UTC, followed by either a whole number of hours or a string in the form "hh:mm".

- As a time zone name, such as "GMT" or "EDT". Not all time zone names are supported by Services, and some countries' time zones have the same names, so if you get an error or the time displayed by Services is wrong, use a UTC offset instead.

Note that Services will not automatically adjust for daylight savings time (summer time); you will have to adjust the time zone manually.


Set the time zone to 5 hours behind UTC.

Set the time zone to 3 hours, 30 minutes ahead of UTC.

Set the time zone to Japan Standard Time (UTC+9:00).

help set mainnick
Syntax: SET MAINNICK nickname

When you have several nicknames linked together, allows you to select which one is displayed in channel access lists. If you later unlink this nick, then a different one will be selected automatically.