Skip to main content
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: 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

FieldDescription
idThe app’s unique identifier
handleThe app’s handle (name)
created_atWhen the app was created
environmentThe environment containing the app
statusCurrent app status (e.g., provisioned)
git_remoteGit remote URL for git-based deployments
last_deploy_operationDetails about the most recent deploy operation
docker_imageThe Docker image configured for direct image deploy
private_registry_usernameUsername for private registry authentication
private_registry_passwordPassword for private registry authentication