Hive System Requirements and Installation

The Hive is delivered as an executable web application in .RUN format.

Connection to web application is carried out via any latest browser.

Hive hardware requirements

The following are the estimated system requirements:

Description Minimal Requirements Recommended Requirements
CPU 2 cores 4 cores
Disk speed - 50 IOPS
Disk size 100 GB 200 GB

Preparing for installation

Before installation, prepare a virtual machine or server with one of the supported operating systems:

  • CentOS 8
  • RHEL 8
  • Ubuntu 18.04
  • Ubuntu 20.04

Install Docker engine and Docker compose.

Hive installation

  1. Download the installation file from;
  2. Copy the file install_hw_bw_en-US_<version>.run to the server using any SSH file transfer client;

    scp install_hw_bw_en-US_<version>.run </server/path>
  3. Execute the following command to grant all the necessary permissions to the installation file (optional):

    chmod +x ./install_hw_bw_en-US_<version>.run
  4. To start installation, run the command:

    bash ./install_hw_bw_en-US_<version>.run

After installation Platform will be started automatically. You will see the following message:

hexway Hive ready to use. UI accessible on http:// or https:// Login as '' password: ''

  • To configure platform settings (f.e. add unique password), use --noconfig option when starting the installation:

    bash ./install_hw_bw_en-US_<version>.run -- --noconfig
    • When installation with --noconfig option finishes, open and edit the file /opt/hw-bw/config/users.ini. For example, in the field [Main] indicate new password and save the file:

      b.root.password = <new_password>
    • To apply changes, run the command (root privileges are required):

    • Start the platform:

      systemctl start hw-bw
  1. Open Platform in the browser by the address https://<ip-server>/.

Platform backups

To create a backup of the Platform, copy and zip the folder /opt/hw-bw to any directory.

To restore data from backup, copy archive with the folder /opt/hw-bw back to the server and unzip it.

Installation of updates

To update Platform:

  1. Download the installation files from;
  2. Copy the installation file install_hw_bw_en-US_<version>.run to the server using any SSH file transfer client;

    scp install_hw_bw_en-US_<version>.run </server/path>
  3. Run the command:

    bash ./install_hw_bw_en-US_<version>.run

During the installation of the updates, Platform will be automatically stopped, saved to a backup and only then the latest updates will be installed.


  1. Platform backups are saved to the /opt/hw-bw_backup folder;
  2. The Platform stores only the three latest backups.

After the installation of updates, Platform will start automatically. All Platform settings (like passwords, connection settings, etc.) will remain the same.

Note: after installation of updates, connected projects (Hive and Apiary) should automatically restore connection, however it may take some time. If connection did not restore, see section Hive troubleshooting.

Default passwords

The default passwords of the root user is generated during the installation and saved to the file /opt/hw-bw/config/local.ini. You can view the default password of the administrator using the command:


See also