Stay organized with collections
Save and categorize content based on your preferences.
In Harbor, a project serves as a logical unit for organizing and managing a
collection of container images. It provides a way to group related artifacts
together and apply specific policies, access controls, and replication rules to
the entire collection. Images cannot be pushed or pulled to Harbor before a
project is created.
Before you begin
To create Harbor projects, you must have the necessary identity and access
roles:
Harbor Project Creator: has access to manage the HarborInstanceProject
resource in their project. Ask your Organization IAM Admin to grant you the
Harbor Project Creator (harbor-project-creator) role.
Before creating Harbor projects, you must sign in to the Harbor UI first for
Harbor to recognize your identity. If this step is missed, the Harbor
project creation might be stuck with a false positive in the
GDC console.
Create a Harbor project
Create a Harbor project using the GDC console or the gdcloud CLI.
Console
In the GDC console, follow these steps:
Click the Harbor Container Registry link in the CI/CD section in
the navigation menu.
Click Create a Harbor project.
Enter the name of the project.
Optional: Vulnerability scanning is enabled by default. To disable automatic vulnerability scanning for Harbor projects, click the Enable vulnerability scanning for the project
toggle. For more information, see Scan for vulnerabilities.
Click Create.
A confirmation message appears stating your project is created successfully.
After your Harbor project is created, sign in to the Harbor UI to confirm that you can view the Harbor project.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eHarbor projects are essential for organizing and managing container images, as they group related artifacts and allow for the application of specific policies and access controls.\u003c/p\u003e\n"],["\u003cp\u003eTo create Harbor projects, users must have the Harbor Project Creator role (\u003ccode\u003eharbor-project-creator\u003c/code\u003e) and sign in to the Harbor UI beforehand to ensure proper identity recognition.\u003c/p\u003e\n"],["\u003cp\u003eHarbor projects can be created using either the GDC console, where users can navigate to the Harbor Container Registry and create projects, or the \u003ccode\u003egdcloud\u003c/code\u003e CLI with the \u003ccode\u003egdcloud harbor harbor-projects create\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eVulnerability scanning is enabled by default when creating a project, however, it can be disabled by clicking the appropriate toggle in the GDC console, or left on if you desire to scan for vulnerabilities.\u003c/p\u003e\n"],["\u003cp\u003eAfter a Harbor Project is created it is recommended to sign in to the Harbor UI to confirm that the project can be viewed.\u003c/p\u003e\n"]]],[],null,[]]