This section describes how to perform a new installation of Harbor.

If you are upgrading from a previous version of Harbor, you might need to update the configuration file and migrate your data to fit the database schema of the later version. For information about upgrading, see Upgrading Harbor.

Before you install Harbor, you can test the latest version of Harbor on a demo environment maintained by the Harbor team. For information, see Test Harbor with the Demo Server.

Harbor supports integration with different 3rd-party replication adapters for replicating data, OIDC adapters for authN/authZ, and scanner adapters for vulnerability scanning of container images. For information about the supported adapters, see the Harbor Compatibility List.

Installation Process

The standard Harbor installation process involves the following stages:

  1. Make sure that your target host meets the Harbor Installation Prerequisites.
  2. Download the Harbor Installer
  3. Configure HTTPS Access to Harbor
  4. Configure the Harbor YML File
  5. Configure Enabling Internal TLS
  6. Run the Installer Script

If installation fails, see Troubleshooting Harbor Installation.

Deploy Harbor on Kubernetes

You can also use Helm to install Harbor on a Kubernetes cluster, to make Harbor highly available. For information about installing Harbor with Helm on a Kubernetes cluster, see Deploying Harbor with High Availability via Helm.

Post-Installation Configuration

For information about how to manage your deployed Harbor instance, see Reconfigure Harbor and Manage the Harbor Lifecycle.

By default, Harbor uses its own private key and certificate to authenticate with Docker. For information about how to optionally customize your configuration to use your own key and certificate, see Customize the Harbor Token Service.

After installation, log into your Harbor via the web console to configure the instance under ‘configuration’. Harbor also provides a command line interface (CLI) that allows you to Configure Harbor System Settings at the Command Line.

Harbor Components

The table below lists the some of the key components that are deployed when you deploy Harbor.

ComponentVersion
Postgresql14.10
Redis7.2.2
Beego2.0.6
Distribution/Distribution2.8.3
Helm2.9.1
Swagger-ui5.9.1

Pages in this section