Skip to content

Quickstart

The init command sets up enumctl in one step. It logs you in and configures your default organization and project.

Terminal window
enumctl init

This runs an interactive flow that:

  1. Asks whether you already have an enum account. Answer no to create one (same as enumctl auth register): enumctl asks for your details, emails you a code, and logs you in once the address is confirmed
  2. Otherwise logs you in (same as enumctl auth login, including device authorization on SSH)
  3. Prompts you to select a default organization and saves it
  4. Prompts you to select a default project, or to name your first one if the organization has none

This is the recommended way to get started after installing enumctl.

On SSH sessions or in scripts, skip prompts and force device login:

Terminal window
enumctl init --project-id proj-... --yes --device
FlagDescription
--project-id / -pDefault project ID (required for non-interactive use)
--org-idOrganization ID (skips the org picker when set)
--yes / -ySkip confirmation prompts
--deviceUse device authorization for login
--browserForce browser callback login even on SSH sessions
--skip-loginSkip login; fail if not already authenticated
  • First-time setup after installing enumctl
  • Switching to a new account, organization, and project in one step
  • Onboarding new team members

After running init, you can immediately start using other commands:

Terminal window
enumctl dns zones list
enumctl projects list