> ## Documentation Index
> Fetch the complete documentation index at: https://www.aptible.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# aptible apps:settings

This command displays deployment settings for an [App](https://www.aptible.com/docs/core-concepts/apps/overview.md), 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:

```shell theme={null}
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:

```shell theme={null}
APTIBLE_OUTPUT_FORMAT=json aptible apps:settings my-app --env production
```

Example JSON output:

```json theme={null}
{
  "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 |