Standard setup

It does not take long to get Helix TeamHub up and running with Standard deployment.

You can either download TeamHub packages and install them manually, or install TeamHub using the Perforce package repositories (recommended).

Step 1: Before you begin

Important

Do not install Helix TeamHub before making sure all prerequisites are met.

Confirm that you have met all of the following prerequisites before installing and configuring Helix TeamHub:

The hardware you are installing TeamHub on must meet the Hardware requirements.
Your firewall must be configured to meet the Firewall requirements.
The computers you are installing TeamHub on must have a supported Operating system requirements.
The computers you are installing TeamHub on must have the TeamHub dependencies installed. See Dependency requirements.
Installing from a repository only: The computers you are installing TeamHub on must be configured for the Perforce repository. See Configuring the Perforce repository.
Helix authentication only: The system must meet the Helix authentication prerequisites.

Step 2: Installing packages

Install using repositories

Install the package itself as root (recommended). If you have downloaded the TeamHub package, see Manually install from a downloaded TeamHub package.

RHEL and CentOS

Configure the Perforce repository if you have not already. See Configuring the Perforce repository.
Run the following command to install the TeamHub package:

sudo yum install hth

Ubuntu

Configure the Perforce repository if you have not already. See Configuring the Perforce repository.
Run the following commands to install the TeamHub package:
```
sudo apt-get update
sudo apt-get install hth
```

Manually install from a downloaded TeamHub package

If you have downloaded the TeamHub package, perform the following steps to install it.

RHEL and CentOS

Run the following command to install the package where <version> is the TeamHub version and <OS-Version> is the operating system version:

rpm -ivh hth-<version>-stable.el<OS-Version>.x86_64.rpm

For example, to install TeamHub 2021.2, run:
- On RHEL/CentOS 7:
  
  rpm -ivh hth-2021.2-stable.el7.x86_64.rpm
- On RHEL/CentOS 8:
  
  rpm -ivh hth-2021.2-stable.el8.x86_64.rpm

Ubuntu

Run the following command to install the package:

dpkg -i hth_<version>-stable~<distro>_amd64.deb

where:
- <version> is the TeamHub release you are installing, such as 2021.2.
- <distro> is bionic or focal.
For example, to install TeamHub 2021.2 on focal, run:

dpkg -i hth_2021.2-stable~focal_amd64.deb

Step 3: Configuring Helix TeamHub

Tip

To change the default Company ID, admin User ID, and password before completing installation, you must make the changes before you run the hth-ctl reconfigure control command for the first time. Otherwise, you can change the values after installation in company and user settings.

To change the default values now, run the following commands:

export HTH_INIT_COMPANY_NAME="<hth>"

export HTH_INIT_USERNAME="<admin>"

export HTH_INIT_PASSWORD="<password>"

<hth> is the Company ID, <admin> is the User ID, and <password> is the password.

Company ID and Username must be 2 - 100 characters and cannot contain spaces. Valid characters: A-Z, a-z, 0-9,-, _

Every installation, upgrade, or configuration change in Helix TeamHub will require the TeamHub Control utility to reconfigure Helix TeamHub for changes to take effect. To enable all required services after installation, run the following command:

sudo hth-ctl reconfigure

Step 4: Bootstrapping

At this stage, Helix TeamHub is installed and running, and can be accessed using hth as Company ID and admin as user ID and password (change them in company and user settings):

http://IP_ADDRESS_OF_YOUR_SERVER/login

The Helix TeamHub instance needs to have a valid license before accessing the dashboard. The license can be managed in TeamHub Admin. See License for more information.

TeamHub Admin can be used to further configure the instance (at minimum, configuring hostname and mail settings is recommended). See Bootstrapping Helix TeamHub for more information.

Enhanced security

For instructions about improving the security of your installation, see Hardening security.