This command displays deployment settings for an App, including the configured Docker image and private registry credentials.

Synopsis

Usage:
  aptible apps:settings [HANDLE] [flags]

Flags:
      --app string           App handle
  -e, --env string           Environment handle (alias)
      --environment string   Environment handle

Examples

View deployment settings for an app:

aptible apps:settings my-app --env production

Example output:

Id: 20120
Handle: my-app
Created At: 2020-05-01 20:25:58 UTC
Environment: production
Status: provisioned
Git Remote: git@beta.aptible.com:production/my-app.git
Last Deploy Operation: 97890638
Docker Image: quay.io/myorg/myapp:latest
Private Registry Username: registryuser
Private Registry Password: registrypass

Get deployment settings as JSON for automation:

APTIBLE_OUTPUT_FORMAT=json aptible apps:settings my-app --env production

Example JSON output:

{
  "id": 20120,
  "handle": "my-app",
  "created_at": "2020-05-01 20:25:58 UTC",
  "environment": {
    "id": 3369,
    "handle": "production",
    "created_at": "2019-10-29 17:12:39 UTC"
  },
  "status": "provisioned",
  "git_remote": "git@beta.aptible.com:production/my-app.git",
  "last_deploy_operation": {
    "id": 97890638,
    "status": "succeeded",
    "git_ref": null,
    "user_email": "deploy@example.com",
    "created_at": "2025-12-01 17:21:16 UTC"
  },
  "docker_image": "quay.io/myorg/myapp:latest",
  "private_registry_username": "registryuser",
  "private_registry_password": "registrypass"
}

Output Fields

Field	Description
`id`	The app’s unique identifier
`handle`	The app’s handle (name)
`created_at`	When the app was created
`environment`	The environment containing the app
`status`	Current app status (e.g., `provisioned`)
`git_remote`	Git remote URL for git-based deployments
`last_deploy_operation`	Details about the most recent deploy operation
`docker_image`	The Docker image configured for direct image deploy
`private_registry_username`	Username for private registry authentication
`private_registry_password`	Password for private registry authentication