Bitrix24 Installation Guide

  1. Extract files from the Bitrix24 distribution package to the root directory of the "Bitrix Environment" folder.
  2. Prepare your system for the installation. If you install Bitrix24 without Bitrix Web Environment, please ensure that it satisfies the following minimum requirements.
    • Install Apache web server if it is not installed yet. Configure it to support PHP. Bitrix24 requires Apache web server version 2.0 or higher, and PHP version 7.4 and higher.
    • Install the desired database engine (MySQL version 5.6 and higher).
    • If you re-install the system, remember to delete all tables from the database.
    • Ensure the disk has extra 100 Mb of free space for the update system to function properly.
  3. Open http://localhost/index.php in your browser.
  4. Follow the installation wizard instructions.

    Installation Step 1 (The Start)

    The installation process starts. The installation wizard displays information about the product and the installation.

    Installation Step 2 (License Agreement)

    The installation wizard displays the license agreement. Read it carefully. You have to accept the license agreement to continue the installation.

    Installation Step 3 (Database Type Selection)

    • License key: If you have already purchased a license, enter the license key here. If you install the product for evaluation purposes, leave the default field value (DEMO).
    • Choose database: You must select the exact database type for which your license has been issued. Selecting any database type other than the one stipulated by the license violates the license agreement and can cause partial or full malfunction of the portal.

    MySQL databases can be installed in UTF-8 encoding. If you choose to install UTF-8 version, mark the Install in UTF-8 Mode option.

    Installation step 4 (Preliminary Verification):

    The installation wizard checks your system for minimum requirements and displays advices on how to tune your system for optimum performance.

    If your system does not match minimum requirements, the problem description in red will display on the top of the screen.
    The detailed description of the incompatibility can be found in the page body. You cannot continue installation until you fix the problem.

    If your system does not match the recommended settings, you can still proceed with the installation. The installer will show the potentially incorrect settings. However, it is strongly recommended that you bring these settings into line with the recommended values. You can verify the system preferences in the Site Check form in Control Panel.

    Installation step 5 (Database Creation):

    Here the license file and the database connection configuration file are created, and the data is uploaded to the database.

    • MySQL:
      • Server: Server that hosts the database engine. Usually "localhost:31006" for local servers.
      • Database user: If checked, a new database user will be created. Otherwise, an existing user will be used.
      • User name: The user name (login) of a database user to access the database.
      • Password: The user password to access the database.
      • Database: if checked, a new database will be created. Otherwise, the existing database will be used.
      • Database name: The name of the database to which the product will be installed.

        Note! If you choose to create a new database or database user, you will have to provide the database administrator's login and password.

        Note! The database administrator's user name and password are used only at the installation and database creation time. This information is not stored in the system.

      • Login: the administrator's login to be used for connection to the database.
      • Password: the administrator's password to be used for connection to the database.
      • Type of database tables: Select here the required type of tables. MySQL supports custom table types as of version 4.0 and higher.
    • Additional parameters:

      • Access permission for portal files: Permissions that will be applied to all newly created files. Access permissions should allow the web server to write to files. The default value is 0777.
      • Access permission for portal folders: Permissions that will be applied to the newly created folders. Access permissions should allow the web server to write to folders. The default value is 0777.

    You can change the database connection parameters manually by editing the file /bitrix/php_interface/dbconn.php.

    Installation step 6

    Here the system creates the database. This step does not require any user interaction. The process of the database creation is indicated by the progress bar. When the database creation is completed, the installation wizard will proceed to the next installation step.

    Installation step 7 (Configuration)

    Here you can configure the portal and create the portal administrator account. This account gives a user the exclusive access to the portal management functions and allows to edit all the portal settings. You can create more users with less permissions later.

    • Login: The portal administrator login to access the portal Control Panel. Login should contain at least 3 symbols which can be Latin letters and digits only.
    • Password: The portal administrator password. Login should contain at least 6 symbols which can be Roman letters and digits only.
    • Confirm password: Type in the password again to ensure its correctness.
    • E-Mail: The e-mail address of the portal administrator.
    • First name: The portal administrator's first name.
    • Last name: The portal administrator's last name.

    When the administrator account is created, the system will start the Demo Portal Creation Wizard.

  5. Follow the installation wizard instructions.

    Note: The Cancel button in the Demo Site Creation Wizard is disabled during the installation. This button is active when the wizard is launched in Control Panel.

    Wizard Step 1

    Here you can select the template for your portal. Templates vary in design, main page layout and settings.

    Wizard Step 2

    Choose the required colour scheme for your site. Each template has a specific set of colour schemes.

    Wizard Step 3

    Specify the name and title of your portal, and provide the company logo.

    Wizard Step 4

    This step configures the installation parameters. If you specify to set the Active Directory preferences, the two additional substeps will follow in which you will configure your Active Directory and provide the AD-to-portal user group mapping.

    Otherwise, the wizard will proceed to the last step.

    Wizard Step 5

    This step installs the portal files and does not require any user interaction. You can watch the installation process in the progress bar. Then, the installation wizard will proceed to the final step.

    Final Step

    This screen shows that the Portal Creation Wizard has completed successfully.

  6. If you need, you can adjust more system settings.
    • Add the following directive to the .htaccess file in the site root folder:

      php_flag session.use_trans_sid off

      to disable adding session identifier to the site links. Remember that your version of the Apache web server may not support this.
    • Add the following directives to the .htaccess file in the site root folder:
      ExpiresActive on
      ExpiresByType image/jpeg "access plus 3 day"
      ExpiresByType image/gif "access plus 3 day"
      to enable image caching. Your Apache web server may not support this.
The latest version of documentation is available at
Copyright © 2001-2022 Bitrix, Inc. | Support