====== HOWTO set up a new user on your Brightbox ======
Adding a new user with sudo privileges is pretty simple.

Add the user with the ''adduser'' script.  It will ask you a few things about the new user, and prompt for a new password. 

<code>
sudo adduser john
</code>

===== Giving sudo access =====

Then to give sudo rights to it, edit the sudo config file as the ''rails'' user: 

<code>
sudo sudoedit /etc/sudoers
</code>

Duplicate the last line, but changing "rails" to whatever your new username is:

<code>
rails ALL=(ALL) ALL
john ALL=(ALL) ALL
</code>

**WARNING**: If you make an error in this file you could lock yourself, and us, out of root access.  The only solution then is for us to boot into rescue mode and fix the file manually for you and this work would be chargeable.  The ''sudoedit'' command should make sure you don't make any obvious mistakes, but double check your work!


===== Granting SSH access =====
Now you need to configure [[docs:ssh|SSH]] to allow access for the new user.  Edit the ssh config at ''/etc/ssh/sshd_config'' and add a new allow users line at the bottom.  You'll see the other user access lines in there:

<code>
AllowUsers rails@*
AllowUsers john@*
</code>

Then reload ssh:
<code>
sudo /etc/init.d/ssh reload
</code>
===== Brightbox GEM warning =====

Our [[docs:gemv2:start|Brightbox GEM]] Capistrano recipes do assume that you're using the ''rails'' user in the usual home directory though.  Changing the user and home directory will cause problems for it, but if you're using your own recipes, you can obviously customize them however you wish.