Skip to main content
Configure the CLI for an Idyl realm without authenticating. This command:
  1. Configures realm endpoints (identity, global API, meta)
  2. Saves realm configuration to ~/.idyl/realms/{realm}/realm.yaml
  3. Does NOT authenticate - use ‘idyl login’ for that
For CI/CD environments: idyl init —realm global.idyl.network export IDYL_TOKEN=sat_xxxxxxxxxxxx idyl deploy myapp —account acme-corp/prod For interactive use, prefer ‘idyl login’ which includes init.

​
Usage

idyl init [flags]

​
Flags

FlagDescription
--globalapi-url <string>Override global API URL (accounts, orgs, IAM)
--identity-url <string>Override identity service URL
--localhostUse localhost endpoints
--meta-url <string>Override meta service URL (subnet discovery)
--realm <string>Realm to initialize (required unless —localhost)

​
Inherited flags

FlagDescription
-a <string>, --account-id <string>Account ID to use (overrides context)
-c <string>, --context <string>Use specific context
--homedir <string>Override config directory (default: ~/.idyl)
-n <string>, --namespace <string>Namespace to use
-o <string>, --output <string>Output format (json|yaml)
-p <string>, --profile <string>Override profile
--subnet <string>Override context subnet for this command

​
Examples

# Initialize for production realm
idyl init --realm global.idyl.network

# Initialize with localhost endpoints
idyl init --localhost

# Initialize with custom endpoints
idyl init --realm custom.example.com \
    --identity-url https://identity.custom.example.com \
    --globalapi-url https://api.custom.example.com \
    --meta-url https://meta.custom.example.com