User

Creating a user

1. Log in to ispmanager with a reseller-level account or above.
2. Navigate to the Users section.
3. Click Add a user on the toolbar.
4. In the Main settings tab, fill in the manadatory fields:
   • Login — username for logging into the ispmanager panel and shell. Value length limit: 32 characters.
   • Name — full name of the user or any other name. Identifies the client in the panel. The information is displayed only for administrators in the Users section → in the Name column.

   • Owner — reseller or administrator who will manage the user. 

     Once the user is created, it's impossible to change its owner.

   • Template — automatically transfers user settings from a template. At the same time, the owner retains the ability to change field values manually.
   • Password — secret set of characters required to enter the panel. Lowercase and uppercase letters, numbers, special characters (for example: @, ?, %) are available for use. Value length limit: 128 characters.
   • Re-enter password — enter the password once again to verify it is correct.
   • Comment — a note, a description, any other text.
   • Backups — adds the user to the periodic backup list.
5. In the Limits tab, specify user limits on the number of panel parameters used. By default, no limits are set.

6. In the Resources tab, specify user limits on the server resource usage. By default, no limits are set. 

   Resource settings are only available in ispmanager host.

7. In the Access tab, specify software that will be available to the user.

   Access settings are only available to accounts with superuser rights.

   • SSL — allows installation of SSL certificates for websites.
   • CGI — allows processing of CGI scripts for websites.
   • PHP as Apache module — for websites, PHP scripts will run with Apache web server rights.
   • PHP as CGI — allows sites to run PHP scripts with the rights of the site owner.
   • PHP as FastCGI (Nginx + PHP-FPM) — allows sites to run PHP scripts with FastCGI technology (Nginx + PHP-FPM).
   • PHP in LSAPI mode — allows site to process PHP scripts using LiteSpeed API for PHP.
   • PHP Composer — enables management of PHP packages via PHP Composer.
   • Node.js — created applications will work with Node.js support.
   • Python — allows to create applications with Python support.
   • Shell — allows the user to work with the panel's shell client and log in to the server via SSH.
8. In the Default values tab, specify domain and PHP parameters.
   • Domain encoding — a standard character set is used or Unicode characters for database entries.
   • PHP handler type — allows selecting one of the modules for processing PHP scripts. The list is available if one of the PHP processing modes is enabled.
   • PHP version (LSAPI module) by default — uses a specific version of PHP to process scripts in the LSAPI module. The list is available if PHP is running in the LSAPI mode.
   • PHP version (CGI) by default — allows setting one of the PHP versions for processing scripts in CGI mode. The list is available if PHP is running in CGI mode.
   • PHP version (PHP-FPM) — uses a specific PHP version to process scripts in PHP-FPM mode. The list is available if PHP is running in FastCGI mode (Nginx + PHP-FPM).
   • PHP version (Apache module) by default — sets the selected PHP version to process scripts in Apache mode. The list is available if PHP packages are processed in Apache mode.
   • Node.js version by default — uses one of the versions of Node.js to process scripts and software. The list is available if Node.js is enabled.
   • Python version by default — allows selecting an alternative version of Python for processing scripts and software. The list is available if Python is enabled.
   • Index page — the address of a starting page for a user. The index page will be opened every time the user tries to go to a non-existent page of the site. You can specify several addresses in a descending order of importance separated by a space. If the first specified page does not exist, the existence of the second page in the list will be checked, and so on. The default address is index.html.

   • Technical domain — specifies the technical domain needed for testing websites.

     Operations with technical domains are only available in ispmanager host.

9. Click Next.
10. In the Select IP address tab, specify the method of IP address allocation.
    • IPv4 allocation type — assigns a separate IPv4 address to the user or creates a user without one.
    • IPv4 address — user IP address in the format: 123.456.789.000. Works only with NAT.
    • IPv6 allocation type — assigns a separate IPv6 address to the user or creates a user without one.
    • IPv6 address — User IP address in the format: 2001:0db8:abf2:29ea:5298:ad71:2ca0:4ff1. Works without NAT.
11. In the Create automatically tab, specify object entities that will be created with the user:
    • Create the selected objects automatically — allows creation of additional entity objects when creating a user. Possible entities: FTP user, site, mail domain.
    • Add an FTP user — allows creation of a new FTP user.
      • Name of the FTP user — name of the user with access to the FTP server. Example: ftp_user. Value length limit: 64 characters.
    • Create a site — allows creation of a new site.
      • Name of the site — domain name of the site. Example: example.com.
      • Select a script — defines a web script for installing CMS or CRM for a website.
    • Create a mail domain — allows creation of a new mail domain.
      • Name of the mail domain — mail domain name. Example: mail-example.com.
12. Click Next.
13. Confirm the settings.

Available actions

1. Log in to ispmanager with a reseller-level account or above.
2. Navigate to the Users section or select a user from the list.
3. The following actions are available on the toolbar:

Button	Description
	Change user account settings
	Delete user
	Enable user
	Disable user
	Log in to the account with user rights
	Import user
	Create an account template
	Configure access to functions
	View user history of changes
	Transfer data between users

Creating user account templates

Templates allow to set default values for the user creation form. Templates are convenient for creating users with similar rights and permissions. For example, when distributing users by tariff plans.

1. Log in to ispmanager with an reseller-level account or above.
2. Navigate to the Users section.
3. Click   Templates on the toolbar.
4. Click  Create a template on the toolbar or Edit an existing one.
5. Specify name of the template.
6. If necessary, configure values in the Limits, Resources, Access and Default values sections.
7. Save the changes.

User skeleton directories

Skeleton directories will be automatically recreated in the home directories of new users.

To create a skeleton directory:

1. Log in to ispmanager with superuser rights.
2. Navigate to the File manager.
3. Go to the /usr/local/mgr5/etc/ directory → create a user.skel folder.
4. Add all the necessary configuration files.
5. Restart the panel.

System user identifiers

By default, the control panel creates user accounts with UID and GID numbers starting with 1010. The first user will be created with UID and GID 1010, the second one will have the 1011 UID and GID, and so on.

If necessary, change the UID and GID values of new users:

1. Add the following parameters to the control panel configuration file /usr/local/mgr5/etc/ispmgr.conf :

   MinGID 1100
   MinUID 1100

   Details

   MinGID — minimum GID value

   MinUID — minimum UID value

2. Restart the control panel. 

   Details

   1. Connect to the server via SSH.

   2. Restart the panel running the following command in the terminal:

      pkill core

   3. Redirect to the panel by following the link: https://IP_ADDRESS:1500/ispmgr.