> ## 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](/core-concepts/apps/overview), 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:

```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        |