Download the Harbor Installer

You download the Harbor installers from the official releases page. Download either the online installer or the offline installer.

  • Online installer: The online installer downloads the Harbor images from Docker hub. For this reason, the installer is very small in size.

  • Offline installer: Use the offline installer if the host to which are are deploying Harbor does not have a connection to the Internet. The offline installer contains pre-built images, so it is larger than the online installer.

The installation processes are almost the same for both the online and offline installers.

Download and Unpack the Installer

  1. Go to the Harbor releases page.

  2. Download either the online or offline installer for the version you want to install.

  3. Optionally download the corresponding *.asc file to verify that the package is genuine.

    The *.asc file is an OpenPGP key file. Perform the following steps to verify that the downloaded bundle is genuine.

    1. Obtain the public key for the *.asc file.

      gpg --keyserver hkps://keyserver.ubuntu.com --receive-keys 644FF454C0B4115C
      

      You should see the message public key "Harbor-sign (The key for signing Harbor build) <jiangd@vmware.com>" imported

    2. Verify that the package is genuine by running one of the following commands.

      • Online installer:

        gpg -v --keyserver hkps://keyserver.ubuntu.com --verify harbor-online-installer-version.tgz.asc
        
      • Offline installer:

        gpg -v --keyserver hkps://keyserver.ubuntu.com --verify harbor-offline-installer-version.tgz.asc
        

      The gpg command verifies that the signature of the bundle matches that of the *.asc key file. You should see confirmation that the signature is correct.

      gpg: armor header: Version: GnuPG v1
      gpg: assuming signed data in 'harbor-offline-installer-v1.10.0-rc2.tgz'
      gpg: Signature made Fri, Dec  6, 2019  5:04:17 AM WEST
      gpg: using RSA key 644FF454C0B4115C
      gpg: using pgp trust model
      gpg: Good signature from "Harbor-sign (The key for signing Harbor build) <jiangd@vmware.com> [unknown]
      
  4. Use tar to extract the installer package:

    • Online installer:

      bash $ tar xzvf harbor-online-installer-version.tgz
      
    • Offline installer:

      bash $ tar xzvf harbor-offline-installer-version.tgz
      

Next Steps