Ispmanager 6 lite, pro, host documentation

Add a website

 

WWW domain (website) — a page or group of pages that are broadcast to the Internet and are available to users by URL. The appearance and content of the website are formed from its source files. When you add a website, a domain name is automatically created for it. Read more in Create a domain name.

Before creating a website, set up a web server in the control panel. Read more in Install a web-server.

To add a website to ispmanager:

  1. In the Main menu choose Sites.
  2. In the form that opens, click the Create website button.
  3. Select the settings mode and complete the creation of the site:
    • Basic settings — you specify only the basic settings. Other settings will use default values (see Basic settings);
    • Extended settings — all site settings are specified. (см. Extended settings).
Note
For stable operation of the ispmanager Host control panel, we do not recommend creating more than 100 sites.

Basic settings

To create a site in the basic settings mode:

  1. Enter the Domain name — the name by which users will access the website.
  2. Specify the root Website directory relative to the owner's home directory. The site files will be stored in this directory (by default, the path will look like www/{The domain name specified in paragraph 1}).
  3. Select the Handler for the site content:
  4. Specify the handler settings:
    • For a site with PHP:
      • Select the CMS (content management system) in the Website/CMS field. CMS is used to fill the website with content (articles, photos, pages, etc.) Without an CMS, adding new content or changing existing content will require editing the website’s source files. Ispmanager supports Drupal, Prestashop, WordPress, joomla, phpBB, BItrix, HostCMS. CMS installation is not available for sites with Node.js handler.
      • select the PHP mode:
        • Apache module — dynamic content is processed by the PHP module of the Apache web server;;
        • CGI —dynamic content is processed by Apache in CGI mode;
        • FastCGI (Apache) — dynamic content is processed by Apache in FastCGI mode;
        • FastCGI (Nginx + PHP-FPM) — PHP-FPM processes dynamic content;
        • LSAPI — PHP mode for the OpenLiteSpeed web server;
        • Not used — the website does not require PHP support (For more info, see PHP modes);
      • Select the required PHP version;
    • For a site with Node.js: specify the node.js version
  5. Select from the list the Database in which the website information will be stored:
    • when you select Create a new database, a window opens in which you need to specify its parameters:
  • Select the Database server.
  • Enter the Database name.
  • Select the Database user or Create new user. To create a new user, specify its Username and Password.

If the website should not use the database, select Do not assign database.
Read more in the Databases section.

6. Specify the settings for the Let's Encrypt SSL certificate. If an SSL certificate is not needed for the site, uncheck Enable SSL option.

7. Press Issue.

Extended settings

The extended settings form consists of the following sections:

Basic settings

  1. Specify the Domain name — the name by which users will access the website.
  2. Specify the Website aliases — additional names for accessing the website. For example, www.example.com or wiki.example.com. By default, an alias "www." is entered after the domain name.
  3. Specify the Website directory relative to the owner's home directory. Files of the website will be stored in this directory.
  4. Select the Handler for the site content:
  5. For a site with PHP select the CMS (content management system) in the Website/CMS builder field. CMS is used to fill the website with content (articles, photos, pages, etc.). Without a CMS, adding new content or changing existing content will require editing the website's source files.
  6. Select the IP addresses that will be assigned to the site.
  7. Select the Website owner — an ispmanager user.
    In /vhosts , a directory with the user's login is created. In this directory, an Nginx configuration file for the WWW domain named .conf. is created.In /conf/vhosts , a directory with the user's login is created. In this directory, an Apache configuration file for the WWW domain named is created.
  8. If necessary, enable the Default website option. This option is used if several websites are assigned to the same IP address and a user requests a website using an IP address or domain name that is not registered on the server with ispmanager. In this case, the control panel will open the default website. If this option is not specified for any website, the control panel will open the website whose domain name is the first alphabetically. The punycode encoding will be used to compare Cyrillic domain names.

Handler

If you selected the PHP handler:

  1. Select the PHP mode :
    • Apache module — dynamic content is processed by the PHP module of the Apache web server;
    • CGI — dynamic content is processed by Apache in CGI mode;
    • FastCGI (Apache) — dynamic content is processed by Apache in FastCGI mode;
    • FastCGI (Nginx + PHP-FPM) — PHP-FPM processes dynamic content;
    • LSAPI — PHP mode for the OpenLiteSpeed web server;
    • Not used — the website does not require PHP support.
  2. Select the required PHP version .

Read more in PHP modes.

If you selected the Node.js handler:

  1. Specify the Node.js version. The version will be installed only for the user who owns the website. The latest version of Node.js and LTS versions starting with 12.13.0 are available.
  2. Select Connection method:
    • Socket file — Node.js application will use Unix sockets to run;
    • Port — Node.js application will use the TCP port to run.
ISPmanager will automatically select a free TCP port for Node.js. The search for a free port starts with the value specified in the NodeJsBackendBind parameter of the ispmanager configuration file. Default value of the parameter — 127.0.0.1:10000.The directory /var/www//data/nodejs/ will be created to run Node.js through a Unix socket.

Database settings

Select from the list the Database in which the website information will be stored.

If you need to create a database, select Create a new database and fill in the same way as described in the Basic Settings section (point 5).

Read more in the section Databases.

Optimization and DDoS protection

  1. If you are using an Nginx web server, select the Compression level of static content on the website. Static content is files that rarely change: images, sounds, music, videos, etc. Such files, as a rule, occupy large volume and slow down loading of the website. File compression reduces the time it takes for users to load the website. The compression level can be set from 1 to 9. The recommended value is 5. To prevent the web server from compressing static content, select level 0.To enable static content compression for the OpenLiteSpeed web server, enable the Сompression option. The compression level for OpenLiteSpeed is not configurable. Read more in Enable compression.
  2. To cache the website content, enable the Cache configuration option. When caching, the result of slow operations, which are performed when opening the website, is stored for a given period of time. The website is accelerated by showing users pre-saved data. However, if the cached content on the website changes, users will receive the old data until the cache expires. To configure the cache settings, specify the Cache period and the Period value . For example, 2 hours.
  3. If you are using an Nginx or OpenLiteSpeed web server, you can Enable DDoS protection. Nginx completely blocks access to the server from the IP address, while OpenLiteSpeed limits bandwidth for the IP address. Specify the protection parameters:
    • Nginx:
      1. Number of Requests per second from one IP address — if this parameter is exceeded, the IP address is blocked for 5 minutes.
      2. Maximum peak attack size — the number of requests per second above which new requests are blocked.
    • OpenLiteSpeed:
      1. Number of Requests per second from one IP address — if this parameter is exceeded, the bandwidth for the IP address is limited.
      2. Bandwidth, bytes/sec — the bandwidth for the IP address. The actual throughput may be slightly higher than this setting. The value will be rounded in 4 Kb increments. To not limit the speed, enter 0.

Additional settings

  1. Choose how to create Autosubdomains:
    • off — do not create subdomains;
    • in a separate directory — subdomain files should be created in subdirectories /var/www/www-root/data/www/ with the name of the subdomain. For example, for the subdomain www.test.example.com with the root directory of /var/www/www-root/data/www/example.com subdomain files need to be created in /var/www/www-root/data/www/test.example.com;
    • in the domain's subdirectory — subdomain files must be created in subdirectories of the root directory of the website. For example, for the subdomain www.test.example.com with the root directory of /var/www/www-root/data/www/example.com subdomain files need to be created in /var/www/www-root/data/www/example.com/test. Note! The option to create Autosubdomains is available if the Default website option is disabled. The function allows you to automatically create subdomains without changing the configuration. The use of autosubdomains relieves you from additional operations. Subdomains are automatically added when subdirectories are created in the root directory of the website. If you select the method of creating autosubdomains "in a separate directory" or "in the domain's subdirectory", the value "*." is added to the Website aliases field.
  2. Specify the Administrator email address — the email address that will be displayed on the web server error pages for this website. By default, after entering the domain name, the field specifies the mailbox webmaster@.
  3. To force a secure HTTPS connection when trying to open a website using the HTTP protocol, enable the Redirect HTTP-requests to HTTPS option. The option is available if an SSL certificate is connected to the website. When redirecting, the server returns a response code "301 Moved Permanently".
  4. Encoding. Encoding defines the set of characters that are used to represent the data of the website::
    • off — the default value for the database will be used;
    • UTF-8 (recommended) — includes all characters of the Unicode standard, including Cyrillic.
      To change the encoding list, create a file /usr/local/mgr5/etc/charset and specify the required values in it.
  5. Specify the Index page of the website. This page opens for the user who goes to the website by domain name and does not specify a particular page. For example, in case of request www.example.com , instead of www.example.com/index.php . Multiple pages can be listed in order of importance, separated by a space. If the first specified page does not exist, the second page will be checked and so on. If you do not specify index pages, the control panel will use values from the global web server settings.
  6. To force a secure HTTPS connection when connecting to the website, enable the HSTS option. The option is available if an SSL certificate is connected to the website. Redirection works if the user's browser has already connected to the website through a secure connection and has saved the connection parameters. When redirecting, the server returns a response code "301 Moved Permanently".
  7. For the server to be able to process SSI commands, enable the SSI option. SSI (Server Side Includes) is a programming language for dynamic page building on the server before displaying them. The option is only available for Apache and Nginx web servers.
  8. Select whether to Use open_basedir for the Apache module mode of PHP:
    • option enabled — PHP scripts have access only to the root directory of the website;
    • option disabled — PHP scripts have access to all server directories.
  9.  If the site needs CGI scripts support, enable the CGI scripts option and specify the CGI script File extensions. The option is only available for Apache and Nginx web servers.
  10. Select the Website logs you want to keep. Read more in Website statistics.
    • Access log — statistics on queries to the website;
    • Error log — web server error statistics for the website;
    • Do not use log — select to disable logging.
  11. Select the log Rotation period :
    • daily;
    • weekly;
    • monthly;
    • by size → specify the Size, MB.
  12.  In the Store archives field, specify the number of log files that will be stored in the archived form. Read more in Set disk quotas.
  13. Select the Report generator that will be used to collect statistics on website traffic. The option is available if you have installed the Apache web server with the awstats or webalizer module. Read more about installation in Install a web-server. Specify the generator settings:
    1. Select the Period for collecting statistics on queries. Additionally, statistics will be collected at the time of log rotation.
    2. Select the Statistics language .
    3. If necessary, enable the option Restrict access to statistics , specify the Password for access and Confirm it . The name of the website owner will be used as the username.

Editing the website settings

To edit the WWW domain settings, select Sites → select the website → Edit button → Edit.

Note
If you change the website settings manually through the web server configuration files, a data mismatch warning will appear when you open the edit form. To apply the changes made manually, press Ok on the edit form. Read more in Manual modification of web-server configuration files.

To change the web server settings for the WWW domain, enter Sites → select the website → Configuration files button.

Note
We do not recommend changing the configuration files unless you are absolutely sure about what you are doing. Before saving the configuration, ispmanager checks only the file syntax, and not the correctness of the settings.


How to enable SEF URL (friendly URL)

SEF URL - the same as a human-readable URL (HCR) -  is an URL that consists of clear words instead of identifiers and reflects the file structure of the site. For example, /product/phone/Apple/ is used instead of /c11/2/33/ or /index.php?cat=10&subcat=2&id=41. 

There are two ways to enable this function:

  • using the command line;
  • via web interface.

 

In the command line

1. Open the configuration file.

/etc/nginx/vhosts/<username>/<website>.conf

Set the parameters.

  • Username - the name of the user who owns the site;
  • Site - site name specified in the list of sites.

 

2. Add the following line to the Nginx configuration file:

try_files $uri $uri/ /index.php?$args;

3. After making the configuration changes, save the file and restart the Nginx service to apply the new settings.

 

Via the control panel interface:

1. Open Main MenuSites → choose site → Edit

 

2. Open the Handler (PHP) drop-down tab. Check the Enable CNC processing checkbox. Click Save button.