Configure the Chef Habitat CLI
After installing Chef Habitat, you need to configure the CLI to work with your development environment and Chef Habitat Builder.
Initial configuration
The hab cli setup command guides you through the essential configuration steps. Run this command and follow the prompts:
hab cli setup
During the setup process, you will be prompted for the following:
A Habitat origin, which is a unique namespace for your packages. Origins organize packages in Chef Habitat Builder. You can use your GitHub username or organization name for your origin. The origin name will prefix all the packages you create.
A cryptographic key pair for your origin:
- private key: Used to sign packages you build
- public key: Used by others to verify your packages
Optional: A Chef Habitat personal access token to:
- Upload packages to Chef Habitat Builder
- Share them with the Chef Habitat community
- Access private origins
For details on generating and using your access token, see the access token documentation.
Optional: Register a Supervisor control gateway secret. This enables remote command-and-control of Supervisors.
Reconfigure the Habitat CLI settings
You can change your settings at any time by re-running:
hab cli setup
Next steps
After configuration is complete, you’re ready to: