====== 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.  A home directory will automatically be created for the user at ''/home/username'', but you can specify this to be anywhere using the ''--home'' option:

<code>
sudo adduser --home /john 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>

===== 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:thebrightboxgem|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.