Back to docs
Configuration

Configuration Overview

Configuration layering and defaults.

Dagy environment configuration (infrastructure/*.yml) includes:

  • dagy.ecr_repository_name: ECR repository name for the Lambda image (must include environment token).
  • dagy.ecr_push_principals: List of IAM principal ARNs allowed to push images to the ECR repository.

Access-token configuration (environment variables):

  • DAGY_ACCESS_TOKEN_TTL_SECONDS (default: 86400)

Scheduler configuration (environment variables):

  • DAGY_EVENTS_QUEUE_URL

Local credentials are stored in ~/.dagy/credentials and are used by the CLI and SDK for authenticated API calls.

Local API configuration is stored in ~/.dagy/config.yaml. You can create or update it with:

dagy config

Example:

version: 1
default_profile: dev
profiles:
  dev:
    api_url: https://api.dev.dagy.io
    last_updated: 2026-02-05T14:22:00Z

CLI commands use the default profile unless --profile <name> is provided or DAGY_PROFILE is set.

See configuration/profiles.md for full profile setup and CLI examples (including --profile for login/logout).