Skip to main content

Create an Origin

An origin is a space on Chef Habitat Builder where you can store, share, and build packages. It is a unique namespace within Chef Habitat Builder, and while you can delete or transfer an origin, you can’t rename an origin after it is created. One example of an origin is the “core” origin, which is the set of foundational packages managed and versioned by the core Chef Habitat maintainers.

You can join existing origins by invitation and you can create your own origins. For more on invitations, see origin membership and RBAC.

Create an Origin

Chef Habitat Builder without origins

To create an origin, select the Create origin button on the My Origins page which opens the Create New Origin form. (Chef Habitat Builder > My Origins )

Creating an origin

First, enter a unique name that you want to associate with your packages. Chef Habitat will only let you create an origin with a unique name. Some examples that you’ll see in Chef Habitat Builder are team names, user names, and abstract concepts.

Next, choose a privacy setting to set as the default for new packages. You can override this setting when uploading individual packages from the CLI or by connecting a plan file that declares a package as private. The difference between public and private packages is:

  • Anyone can find and use public packages
  • Only users with origin membership can find and use private packages

When you select Save and Continue, Chef Habitat Builder:

  1. Creates your origin
  2. Creates an origin key pair
  3. Redirects Chef Habitat Builder to the origin page

Origin successfully created

Create an Origin with the Chef Habitat CLI

Use the hab origin commands to manage your origins from the command line.

Create an origin from the command line with the hab origin create command

hab origin create <origin>

The results of this command differ slightly from creating an origin on the Chef Habitat Builder site. The CLI command:

  1. Creates an origin on the Chef Habitat Builder site
  2. Does not generate an origin key pair

For more information, see the hab origin create CLI documentation.

Edit this page on GitHub

Thank you for your feedback!


Search Results