aptible apps:settings

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

Synopsis

Usage:
  aptible apps:settings HANDLE

Options:
  --env, [--environment=ENVIRONMENT]

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: [e-mail]: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": "[e-mail]:production/my-app.git",
  "last_deploy_operation": {
    "id": 97890638,
    "status": "succeeded",
    "git_ref": null,
    "user_email": "[e-mail]",
    "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