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.

note

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.