Adding FTP Users to Your VPS Domain

This article is designed to help VPS customers create user accounts with FTP access to their website.

These instructions assume you have Cruzio VPS service, and have already set up a domain on your VPS slice.

Overview

When you use the Virtualmin control panel to set up a domain on your VPS slice, a default FTP account is automatically created for the root user. However, you may wish to create one or more additional FTP accounts.

When you create a new user account user@yourdomain.com, you can give the account one of the following sets of permissions:

  • Email access only
  • FTP access only
  • Email and FTP access

You can change these permissions later on a per-user basis.

Creating an FTP User

The instructions below are for creating a user account with FTP-only access. (To create a user with email-only access or both email and FTP access, adapt the instructions accordingly.)

  1. Log in to your Virtualmin Control Panel at clientlogin.cruziohost.com:10000, replacing clientlogin with the login name you chose when you signed up. When prompted, enter your root username and password.
  2. From the drop-down menu on the left, select the domain you wish to add FTP users to.
  3. From the left-hand menu, click “Edit Mail and FTP Users”.
  4. On the far right side of the page that appears, click “Add a website FTP access user”.

    In the “Website FTP access user details” section, fill in the user’s username/email address, real name, and password. You can change this password later, if you wish.

  5. In the “Quota and home directory settings”, you can specify which directory you want the user to start in when they log into the domain via an FTP client.

    If you want the user to start in the top level directory of the website, set the “Home directory” to “Main website directory”. If you want the user to start in a specific existing subdirectory, set the “Home directory” to “Website subdirectory”, and specify that subdirectory.

    Any website subdirectory must fall under the website’s main public_html directory, so if you want to specify the subdirectory located at public_html/folder1, simply type folder1.

    (Note that setting the home directory does not restrict the FTP user to that directory. To restrict access to the home directory, follow the next set of instructions below.)

  6. Click the “Create” button.

Restricting FTP User Access to Home Directories

Important: back up your VPS before continuing, since mistakes can cause serious problems.

  1. Log in to your Virtualmin Control Panel at clientlogin.cruziohost.com:10000, replacing clientlogin with the login name you chose when you signed up. When prompted, enter your root username and password.
  2. On the upper left, select the Webmin control panel tab. Select “Servers”, and then “ProFTPD Server”. Click the icon titled “Files and Directories”.
  3. Next to the “Limit users to directories” option, under the “Directory” heading, select “Home directory”. Under the “Unix groups” heading, select “Everyone”. This will limit all FTP users to the home directory you specified for each user.
  4. Click “Save”.
  5. Once you return to the main ProFTPD Server page, click “Apply Changes”.

Allow full access to a specific user

To make an exception, and allow a particular user to access more than just their home directory:

  1. On the ProFTPD Server page, click on the “Files and Directories” icon again.
  2. Next to the “Limit users to directories” option, there should be a new line below the existing user(s) you previously set up. Under the “Directory” heading, select “None”; under the “Unix groups” heading, type the username. (Make sure the “Unix groups” heading is not set to “Everyone” or this will contradict the settings you specified earlier.)
  3. Click “Save”.