Managed Services - How to Add a Customer with Adduser

Last Updated: 04/03/2017
Back to:
One Column
Two Column


Adding a customer with adduser will create an account for him/her on your server that is in sync with the campus user database (uniquid). Follow the steps below to create an account.

This tutorial applies to the following operating system(s):
  • MAC

1. Gather the Information

The customer for whom you are creating an account must already be registered with the campus database. If the customer has an e-mail address, the person is in the system. If not, contact the IT Service Center to get a CU-Boulder account created for the customer.

Make sure you know the username of the customer. The username "buffalor" for Ralphie Buffalo will be used for the purposes of this tutorial. Substitute the real username where appropriate. Chip Buffalo, with the username "buffaloc" will be used as a replacement for your username.

Determine on which server the new customer should have an account, and ensure that you have adduser privileges on this machine. If you are unsure, contact MS&C/UnixOps at trouble@<machinename>, where <machinename> is the server in question. The server "mailserver" will be used as an example in this tutorial.

2. Log In and Start Adduser

Use an ssh client to log into the server. Note that this is not necessarily the machine the new customer will be working on but its server. You do not need to have an X server running to use adduser.

Visual representation of code.

You should now have a command prompt on the server.

Visual representation of code.

Start adduser by entering "/usr/local/adduser/bin/adduser" at the prompt.

Visual representation of code.

You should see a screen that looks like this:

Visual representation of code.

You can abort adduser at any time by typing <Ctrl-C>. Do not type <Esc> unless you want to add the current user (see below).

3. Enter the new customer information

Adduser should start you on the "Host" line. Type the name of the server here and press <Enter>.

Visual representation of code.

You should now be on the "Login" line. Enter the new customer's username here and press Enter>.

Visual representation of code.

Adduser should look up the customer on uniquid and display the information. Your cursor should now be on the "Type" line. Press <Tab> to get a listing of supported account types.

Visual representation of code.

Use the arrow keys to select the appropriate type for the new person and press <Spacebar> to select it.

Visual representation of code.

Now enter a temporary password for the new customer's account. DO NOT HAVE THE NEW CUSTOMER SET HIS/HER PASSWORD HERE. Press <Enter>.

Visual representation of code.

Leave "Shell" and "Groups" as they are and update the remainder of the information as available. You can use <Ctrl-k> and <Ctrl-j> to move the cursor up and down a line respectively.

When you are done, press <Esc> to make the account.

Adduser will prompt you at the bottom:

Visual representation of code.

Press "y" to add the customer. It will then make the account. If all went well, you should see "Account added: buffalor" at the bottom of the screen.

Now exit adduser by typing <Ctrl-C>, then "y" at the prompt. You can terminate your ssh session as well.

4. Setting the new customer's password

If this system is a Linux server using IdentiKey for passwords, simply run:

sudo passwd -l USERNAME

where USERNAME is the campus IdentiKey login name of the user.

If this system does not use IdentiKey for passwords, have the new customer ssh into the server with the temporary password. DO NOT E-MAIL THEM THIS PASSWORD. Once logged in, the customer will need to change the password by typing "passwd" at the prompt. The customer will be prompted once for the old (temporary) password and twice for the new one.

Back to top