FASTPANELWIKI

Users

Disk quota

On this page

Introduction

Disk Quota is a feature that helps to limit disk usage for each user.

Linux OS has special tools to limit disk usage for specific users and groups.

How to setup disk quota?

To control Disk Quota in FASTPANEL® it is required to install Quota application. When using a virtual server it is required to note your virtualization system type. Some of them, like OpenVZ, requires additional settings on the host server.

You can set up a disk quota for a user in the user creation wizard or in the website creation wizard on user creation stage.

Setting up Disk Quota on a user creation stage

Disk quota can be specified in the User Creation Wizard in the Quota field.

  1. Go to side menu → "Settings" → "Users"

  2. Click "Create" button

  3. In the "Quota" field specify maximum disk space available for the user files

note

Zero value means no limit.

Changing Disk Quota value

To change Disk Quota value:

  1. Go to side menu → "Settings" → "Users"
  2. Click "Edit user"
  3. Set the desired value in the corresponding field.

Setting Disk Quota in the website creation wizard

On a user creation stage, the second step, if "New" was chosen in the Site Owner field, an option to set Disk Quota will become available.

How often does it check the amount of space used by a user?

Disk space usage is being checked instantly. OS will not allow a user to upload more than it was allowed.

What to do if there are errors with Disk Quota?

In this case, you simply need to run Quota recalculation:

  1. Go to side menu → "Settings" → "Users"
  2. Click "Recalculate disc quota"
  3. Confirm quota recalculation
caution

Quota recalculation can increase the load on the disk subsystem and, as a result, the whole server.

Technical features of Disk Quotas

For Disk Quotas to work usrjquota=aquota.user and grpjquota=aquota.group params are specified in /etc/fstab

aquota.user and aquota.group files are created in root partition.

To view disk quota statistics run the following command in the terminal:

repquota -au

FASTPANEL API

On this page

Introduction

FASTPANEL® API gives you a flexible way to manage the control panel without relying on the web interface. It helps automate routine operations, integrate FASTPANEL® with external services, and build more efficient infrastructure management workflows.

Token management

To open the API token management section, click your username in the top-right corner of the FASTPANEL® interface and select "API tokens".

To create a new API token, click "Add API Token". A form will appear for you to fill out:

  • Name — an arbitrary name for the token.
  • Full API access — leave this enabled if full access is required.
  • Scopes — disable full API access to select access restrictions: read-only, DNS or metrics.
  • Constraint IP — restricts API access to the IP address specified in this field.
  • Expires at — the token expiration date.

To complete the token creation, click "Add".

important

Be sure to save the token - you will not be able to access it again!

Using tokens

Detailed FASTPANEL® API documentation is available at the following link.

For example, to retrieve a list of control panel users, you can use the following command:

curl 'https://yourserverip.example/api/users?page=1&per_page=20' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

where

  • YOUR_SECRET_TOKEN — the token created earlier
  • yourserverip.example — the IP address or domain name of your server

User control

On this page

Introduction

FASTPANEL® is a multi-user control panel that allows you to use the following benefits:

  • Differentiation of access to the server
  • Individual file permissions
  • Individual settings and access levels to the control panel for each user
  • Ensuring non-proliferation of infection in the event of hacking one of the users

User control

Working with users (creating, deleting, editing) is done in the "Users" section

This section contains a list of all users available to the current user that was created in the control panel

For each user the following actions are possible:

  • Change user password
  • Enter the control panel with the rights of a specific user
  • Temporary block/unblock a user
  • Edit user settings
  • Delete a user

User creation form

It is required to fill in the following fields to create a user:

  • User name
  • Password
  • Role - user or reseller
  • Maximum sites allowed
  • Quota - disk space usage limitation for a user

User edit form

The following settings can be edited in the User Edit menu:

  • Maximum sites limit
  • PHP version used in command-line interface of the selected user
  • Quota

How to change a user password?

There are several ways to change a password for a user:

  • By clicking "Change password" in the "Users" section of the FASTPANEL®
  • There are two more ways to change the user password via SSH. Via default Linux utility passwd or via mogwai utility:
passwd {user_name}
mogwai chpasswd -u {user_name} -p {password}

Who can create new users?

In FASTPANEL®, except by super administrator user, new users can be created by a user with a Reseller role.

To create a Reseller user, in the user creation menu select "Reseller" in the Role field. In this case, additional fields will become active: "Create users" and "Acceptable number of users".

Create a user with a site

Another way to create users.

On the second step of the site creation wizard, you can choose to create a new user. In this case, you can also specify a disk quota for the new user. Password will be generated automatically. Login and password information will be shown after the site is created.

Can I connect to my server via SSH with the rights of the control panel user?

Each FASTPANEL® user is also an OS user which means you can connect via SSH to your server using the credentials of a control panel user.

In the user edit menu, you can specify a PHP version that will be used as the default for the user in the SSH session.

FTP-accounts

On this page

Introduction

FTP-account is an account to work via FTP – File Transfer Protocol.

Having an FTP login and password, you can connect to the server and work with your website files (browse, edit, upload and etc.)

One of the most comfortable and popular ways to upload a big amount of data to the server is using FTP.

Creating FTP users

To create an FTP-account go to "Settings" → "FTP" and click "New account"

In the opened window, enter desired Login and Password in the corresponding fields.

note

In the field "Permissions" you can allow a new created user only to browse files without the ability to edit or upload them. In order to do that choose "Read only" option in the "Permissions" field.

In the field "Website" choose the website you are creating an FTP access to. "Home directory" field can be left intact.

To complete your FTP account creating, click "Save". Now you are able to connect to your server via FTP by using the data entered in "Login" and "Password" fields.

SFTP-accounts

On this page

Introduction

Why do I need SFTP if there is a simple FTP?

FTP protocol is the most popular one among Internet users as it simplifies file transfer.

Unfortunately it does not have any protection as long as SSL/TLS is not used. In the event when traffic is sniffed via MITM, data can easily be compromised.

SFTP exists as an alternative to FTP

Some theory:

SFTP was developed to make file transfer secure.

It was designed to be platform independent which makes possible to used on any OS.

Most commonly SFTP works over SSH that removes all encryption responsibilities from it.

Its main task is to work with files.

What are the advantages of SFTP?

  • Ensuring full security of all information transferred.
  • Ability to transfer metadata (such as file modification time).
  • Easy to use when setting up firewalls
  • Supported by most file transfer clients (FileZilla, WinSCP)

How does SFTP implemented into FASTPANEL®?

Whenever OpenSSH is installed you may connect to your server via SFTP by using a system user. In this case aside from SFTP access the user will be granted an SSH access as well.

FASTPANEL® uses mod_sftp for proFTPd server that allows SFTP access without full SSH access and rights to create additional OS users.

info

FASTPANEL® uses non-typical port 2222 for SFTP connections.

How to enable SFTP in FASTPANEL?

It is fairly easy. First of all simply install SFTP module in the "Application" menu.

After the installation SFTP menu will appear in sites cards where SFTP accounts can be controlled