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

# Access

> An access dictionary that defines the access control for roles accessing app environments.

Optional in [single-runtime](https://developer.upsun.com/docs/configure-apps/app-reference/single-runtime-image.md#primary-application-properties) and [composable](https://developer.upsun.com/docs/configure-apps/app-reference/composable-image.md#primary-application-properties) images.

The `access` dictionary has one allowed key:

| Name | Allowed values | Default | Description |
| - | - | - | - |
| `ssh` | `admin`, `contributor`, or `viewer` | `contributor` | Defines the minimum role required to access app environments via SSH. |

In the following example, only users with `admin` permissions for the
given [environment type](https://developer.upsun.com/docs/administration/users.md#environment-type-roles)
can access the deployed environment via SSH:

> [tab] Single-runtime image
>
>  applications:
> &#x20;     \<APP\_NAME>:
> &#x20;       type: "python:\{\{version:python:latest}}"
> &#x20;       source:
> &#x20;         root: "/"
> &#x20;       access:
> &#x20;         ssh: admin
> &#x20;    &#x20;

> [tab] Composable image
>
> &#x20;applications:
> &#x20;     \<APP\_NAME>:
> &#x20;       type: "composable:\{\{version:composable:latest}}"
> &#x20;       stack:
> &#x20;         runtimes: \[ "python@\{\{version:python:latest}}" ]
> &#x20;       source:
> &#x20;         root: "/"
> &#x20;       access:
> &#x20;         ssh: admin
> &#x20;    &#x20;


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.