cdnctl Reference

install

curl -fsSL https://cdn.com.tr/downloads/cdnctl/install.sh | sh

# pin a specific version
CDNCTL_VERSION=0.5.0 curl -fsSL https://cdn.com.tr/downloads/cdnctl/install.sh | sh

Downloads the latest release for your platform, verifies it against the published checksums, and installs the binary.

update

cdnctl update --check
cdnctl update --yes
cdnctl update --version <version> --yes

Self-updates the installed binary from the public release channel. The downloaded archive is verified against the published checksum file before the binary is replaced.

login

cdnctl login --email <email> --password <password> [--endpoint <url>]

Authenticates and saves a token to ~/.cdnctl/config.json. Use once per machine; token is reused for subsequent commands.

configure

cdnctl configure [--endpoint <url>] [--token <token>]

Manually sets the endpoint or token without logging in. Useful for CI environments or token-based automation.

accounts list

cdnctl accounts list

Lists all CDN accounts accessible to the authenticated user. The uuid field from this output is used as --account in all other commands.

container apps list

cdnctl container apps list --account <uuid>

Lists all container apps under the account.

container apps create

cdnctl container apps create \
  --account <uuid> \
  --name <name> \
  --image <registry/image> \
  [--tag <tag>] \
  [--port <port>] \
  [--healthcheck <path>] \
  [--healthcheck-type http|tcp|none] \
  [--metrics-port <port>] \
  [--metrics-path <path>] \
  [--replicas <n>] \
  [--plan <code>] \
  [--domain <domain>] \
  [--env-json '{"KEY":"value"}'] \
  [--secrets-json '{"SECRET":"value"}'] \
  [--registry-credential <uuid>] \
  [--persistent-mount-path <path>] \
  [--persistent-storage-gb <n>]

Creates a new container app record and first revision. Does not deploy — run deploy after create.

container apps update

cdnctl container apps update \
  --account <uuid> \
  --app <uuid> \
  [--image <registry/image>] \
  [--tag <tag>] \
  [--port <port>] \
  [--replicas <n>] \
  [--healthcheck <path>] \
  [--healthcheck-type http|tcp|none] \
  [--metrics-port <port>] \
  [--metrics-path <path>] \
  [--domain <domain>] \
  [--env-json '{"KEY":"value"}'] \
  [--secrets-json '{"SECRET":"value"}'] \
  [--registry-credential <uuid>] \
  [--persistent-mount-path <path>]

Updates app settings. Only the flags you pass are changed. Run deploy after update to publish the new revision.

container apps deploy

cdnctl container apps deploy --account <uuid> --app <uuid>

Publishes the current configuration as a new revision. Use wait afterwards to block until the deployment reaches a target status.

container apps expose

cdnctl container apps expose --account <uuid> --app <uuid>

Mints a permanent, immutable <uid>.cdn.com.tr subdomain for the app. The subdomain never changes even if a custom domain is updated.

container apps restart

cdnctl container apps restart --account <uuid> --app <uuid>

Performs a rolling restart of all running replicas without creating a new revision.

container apps scale

cdnctl container apps scale --account <uuid> --app <uuid> --replicas <n>

Changes the replica count immediately without creating a new revision. Pass 0 to scale the app to zero.

container apps show

cdnctl container apps show --account <uuid> --app <uuid>

Returns full app configuration including the list of revisions. Use the revision UUIDs from this output with rollback.

container apps rollback

cdnctl container apps rollback --account <uuid> --app <uuid> --revision <revision_uuid>

Re-deploys a previous revision. Use show to list available revision UUIDs.

container apps operations

cdnctl container apps operations --account <uuid> --app <uuid>

Lists all platform operations recorded for the app, such as deploys, restarts, and scale events.

container apps status

cdnctl container apps status --account <uuid> --app <uuid>

Returns the current runtime status and last operation result of the app.

container apps wait

cdnctl container apps wait \
  --account <uuid> \
  --app <uuid> \
  --status <target> \
  [--timeout <seconds>] \
  [--interval <seconds>]

Polls app status until it reaches --status or the timeout expires. Exits 0 on success, 1 on failure or timeout. On failure, includes diagnose output automatically.

container apps logs

cdnctl container apps logs --account <uuid> --app <uuid> [--tail <n>]

Returns recent container log lines.

container apps diagnose

cdnctl container apps diagnose --account <uuid> --app <uuid> [--tail <n>]

Returns a combined status and log snapshot. Used automatically by wait on failure. Run this first when an app is stuck or failing.

container apps delete

cdnctl container apps delete --account <uuid> --app <uuid> --yes

Permanently deletes the app and all its revisions. This operation is irreversible.

container preflight

cdnctl container preflight --account <uuid>

Checks that the account is ready to run container workloads and returns a list of any issues found.

container registry-credentials list

cdnctl container registry-credentials list --account <uuid>

container registry-credentials create

cdnctl container registry-credentials create \
  --account <uuid> \
  --name <name> \
  --password <token> \
  [--registry-url <url>] \
  [--username <user>]

container registry-credentials delete

cdnctl container registry-credentials delete \
  --account <uuid> \
  --credential <credential_uuid> \
  --yes

Permanently removes a registry credential. Any apps that reference this credential will fail to pull images on the next deploy.

container addons list

cdnctl container addons list --account <uuid> --app <uuid>

Lists all add-ons currently attached to the app.

container addons enable-database

cdnctl container addons enable-database \
  --account <uuid> \
  --app <uuid> \
  [--plan <code>] \
  [--env-prefix <prefix>] \
  [--storage-mb <n>] \
  [--url-scheme <scheme>]

container addons disable-database

cdnctl container addons disable-database --account <uuid> --app <uuid>

container addons enable-redis

cdnctl container addons enable-redis \
  --account <uuid> \
  --app <uuid> \
  [--plan <code>] \
  [--env-prefix <prefix>]

container addons disable-redis

cdnctl container addons disable-redis --account <uuid> --app <uuid>

container addons enable-postgres

cdnctl container addons enable-postgres \
  --account <uuid> \
  --app <uuid> \
  [--plan <code>] \
  [--env-prefix <prefix>] \
  [--storage-mb <n>]

container addons disable-postgres

cdnctl container addons disable-postgres \
  --account <uuid> \
  --app <uuid> \
  [--delete-data --confirmation <app_name>]

Disables the Postgres add-on. By default data is retained. Pass --delete-data together with --confirmation to permanently destroy all data.

container addons enable-nats

cdnctl container addons enable-nats \
  --account <uuid> \
  --app <uuid> \
  [--plan <code>] \
  [--env-prefix <prefix>] \
  [--storage-mb <n>]

container addons disable-nats

cdnctl container addons disable-nats \
  --account <uuid> \
  --app <uuid> \
  [--delete-data]

Disables the NATS add-on. Pass --delete-data to permanently destroy all JetStream data.

container compose preview

cdnctl container compose preview --account <uuid> --file docker-compose.yml

Parses the compose file server-side and returns the import plan: apps to be created, add-on mappings, environment/secret key classification, warnings, unsupported services, and an entitlement check. Creates nothing. Secret values are never echoed back — only key names.

container compose apply

cdnctl container compose apply --account <uuid> --file docker-compose.yml --yes

Applies the import: creates the apps in dependency order and enables the mapped add-ons. All-or-nothing — if any app name conflicts with an existing app, or any service is unsupported (e.g. uses build:), nothing is created. Deploy each created app afterwards with container apps deploy.

container imports list

cdnctl container imports list --account <uuid> --app <uuid>

Lists all imports and their current status for the app.

container imports database

cdnctl container imports database \
  --account <uuid> \
  --app <uuid> \
  --file <path/to/dump.sql.gz>

Uploads and queues a gzip-compressed SQL dump for import into the managed database.

container imports files

cdnctl container imports files \
  --account <uuid> \
  --app <uuid> \
  --file <path/to/archive.tar.gz> \
  [--target-path <path>]

Uploads and extracts a tar.gz archive into the persistent volume.

container imports cancel

cdnctl container imports cancel \
  --account <uuid> \
  --app <uuid> \
  --import <import_uuid>

Cancels a queued or in-progress import. Has no effect if the import has already completed.

container jobs list

cdnctl container jobs list --account <uuid> --app <uuid>

container jobs create

cdnctl container jobs create \
  --account <uuid> \
  --app <uuid> \
  --name <name> \
  --schedule "<cron expression>" \
  --path </endpoint/path> \
  [--method <POST|GET>] \
  [--secret-header-name <header>] \
  [--secret-source <ENV_VAR>] \
  [--enabled]

container jobs run

cdnctl container jobs run \
  --account <uuid> \
  --app <uuid> \
  --job <job_uuid> \
  [--wait] \
  [--timeout <seconds>] \
  [--interval <seconds>]

Triggers an immediate one-off run of the job. Use --wait to block until the run completes or fails.

container jobs delete

cdnctl container jobs delete \
  --account <uuid> \
  --app <uuid> \
  --job <job_uuid> \
  --yes

Permanently removes the scheduled job.

object-storage buckets list

cdnctl object-storage buckets list --account <uuid>

object-storage buckets create

cdnctl object-storage buckets create \
  --account <uuid> \
  --name <bucket-name> \
  [--visibility private|public]

object-storage buckets usage

cdnctl object-storage buckets usage --account <uuid> --bucket <bucket_uuid>

Returns current storage usage statistics for the bucket.

object-storage buckets delete

cdnctl object-storage buckets delete --account <uuid> --bucket <bucket_uuid> --yes

Permanently deletes the bucket and all objects inside it. This operation is irreversible.

object-storage access-keys create

cdnctl object-storage access-keys create \
  --account <uuid> \
  [--bucket <uuid>] \
  [--name <name>]

Creates an S3-compatible access key. The secret_key field in the response is shown once and never returned again. Copy it before closing the terminal.

object-storage access-keys rotate

cdnctl object-storage access-keys rotate --account <uuid> --key <key_uuid>

Generates a new secret for the access key while keeping the same key UUID and bucket scope. The new secret_key is returned once and never again. Update any clients before rotating in production.

object-storage access-keys revoke

cdnctl object-storage access-keys revoke --account <uuid> --key <key_uuid> --yes

Permanently revokes and deletes the access key. Any clients still using this key will receive authentication errors immediately.

object-storage bindings create

cdnctl object-storage bindings create \
  --account <uuid> \
  --app <uuid> \
  --bucket <uuid> \
  [--access-key <uuid>] \
  [--env-prefix <prefix>]

Binds a bucket to an app. S3 credentials and endpoint are injected as environment variables on the next deploy.

object-storage bindings delete

cdnctl object-storage bindings delete \
  --account <uuid> \
  --app <uuid> \
  --binding <binding_uuid> \
  --yes

Removes the bucket binding from the app. The bucket and access key are not affected; only the environment variable injection is removed on the next deploy.