Skip to main content

Creating a new project

When you log in for the first time, Minder automatically creates a new project to manage your entities (repositories, artifacts, etc). You can also create projects for additional GitHub organizations that you manage.

Alternatively, you can register multiple entity providers within a project, for example to manage resources from several GitHub organizations from a single Minder project.

Prerequisites​

  • A Minder account
  • A GitHub organization that does not have the Stacklok Cloud GitHub App installed. Owner access is required to install new apps.

Create a new project​

To create a new Minder project, add the Stacklok Cloud GitHub App to a GitHub organization that you own. When the app is installed on a GitHub organization that is not already registered with Minder, a new project named github-<org-name> is created and you are assigned the Admin role.

If the organization already has the GitHub App installed, an existing Minder project admin can invite you from User Management.

Add a GitHub organization to an existing project​

Use the CLI command minder provider enroll to register a new GitHub provider within an existing Minder project. The selected GitHub organization is added to the project instead of creating a new one.

If you previously enabled automatic registration of new repositories in

your project, this is a per-provider setting and you must separately enable it for the new GitHub organization.

See Automatically registering new repositories.

Next steps​

Register repositories from the new GitHub organization to begin applying profiles.