For the complete documentation index, see llms.txt.

chainctl starter init

  2 min read

chainctl starter init

Initialize a new catalog starter organization.

Synopsis

Initialize a new catalog starter organization.

A catalog starter organization gives a team free access to a small set of Chainguard images for evaluation. Each starter org is entitled to a limited number of images of your choice (base or application); the exact quota is shown by ‘chainctl starter status’. Other Chainguard platform features may be unavailable to starter organizations; refer to the documentation for the current scope.

This command is interactive. It will:

1. Prompt you to authenticate with a supported identity provider.
2. Register a new Chainguard identity for your email address.
3. Create a new starter organization. With a business email address it
   is named after your email domain. With a personal email address you
   name it yourself, at a prompt or with --name, and its registry and
   package paths use its ID instead of the name.

Once your organization exists, the Chainguard platform will automatically entitle it to choose images to be added. It should be ready within a few minutes.

Authentication requirements:

* Use a business email address to get an organization named after your
  company's domain. Where personal email providers (Gmail, Yahoo, etc.)
  are accepted, the organization isn't tied to any domain.
* Authentication must use one of:
    - Email and password; or
    - Google, only if your business uses a Google Workspace account
      registered to your business domain.

If this command fails and you think the organization already exists, you may follow up by running ‘chainctl starter request-access’ to request access.

chainctl starter init [flags]

Options

      --name string   Name of the organization, when you sign up with a personal email address. It can't look like a domain name. Ignored for an organization named after your email domain.

Options inherited from parent commands

      --api string         The url of the Chainguard platform API. (default "https://console-api.enforce.dev")
      --audience string    The Chainguard token audience to request. (default "https://console-api.enforce.dev")
      --config string      A specific chainctl config file. Uses CHAINCTL_CONFIG environment variable if a file is not passed explicitly.
      --console string     The url of the Chainguard platform Console. (default "https://console.chainguard.dev")
      --force-color        Force color output even when stdout is not a TTY.
  -h, --help               Help for chainctl
      --issuer string      The url of the Chainguard STS endpoint. (default "https://issuer.enforce.dev")
      --log-level string   Set the log level (debug, info) (default "ERROR")
  -o, --output string      Output format. One of: [csv, env, go-template, id, json, markdown, none, table, terse, tree, wide]
  -v, --v int              Set the log verbosity level.

SEE ALSO

Last updated: 2026-10-12 15:51