# User Session Expiration

You can configure the session expiration time to determine how long a user stays signed in before a new login is required. When the session is close to expiring, the Admin UI shows a ten minute countdown in the top right corner and users receive a warning message.

## Session Expiration Parameters

You can set the session expiration time through the following parameters. The parameter differs between Kubernetes and Docker deployments.

{% tabs %}
{% tab title="Kubernetes Parameters" %}

### Kubernetes Parameter

| Parameter                                | Description                                                                                                                                                                                                                                                                                                                                        | Default |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `global.authentication.tokenExpiryHours` | <p>Defines how long (in hours) a user stays signed in before being logged out for security reasons. After the configured time has passed, the user session expires and a new login is required.<br><br>The Admin UI displays a ten-minute countdown in the top right corner, and users receives a warning ten minutes before the session ends.</p> | `12`    |
| {% endtab %}                             |                                                                                                                                                                                                                                                                                                                                                    |         |

{% tab title="Docker Parameters" %}

### Docker Parameter

| Parameter                               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Default |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `CYBUS_AUTH_TOKEN_EXPIRE_TIME_IN_HOURS` | <p>Defines how long (in hours) a user stays signed in before being logged out for security reasons. After the configured time has passed, the user session expires and a new login is required.<br><br>The Admin UI displays a ten-minute countdown in the top right corner, and users receives a warning ten minutes before the session ends. If the variable is not set, or if the value is negative or not a valid number, the system uses the default duration of 12 hours.</p> | `12`    |
| {% endtab %}                            |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |         |
| {% endtabs %}                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |         |

## Setting the Session Expiration Time

You can adjust the session duration by modifying the corresponding parameter for your deployment.

{% tabs %}
{% tab title="Kubernetes" %}

### Changing the Session Expiration Time (Kubernetes)

1. Open the `values.yaml` file.
2. Set the `global.authentication.tokenExpiryHours` Helm value to the desired number of hours.

{% code lineNumbers="true" %}

```yaml
global:
  authentication:
    tokenExpiryHours: 8
```

{% endcode %}

3. Upgrade your Helm chart to apply the Helm configuration changes. For instructions, see [Applying Helm Configuration Changes](/2-1-2/documentation/connectware-on-kubernetes/connectware-helm-chart.md#applying-helm-configuration-changes).
   {% endtab %}

{% tab title="Docker" %}

### Changing the Session Expiration Time (Docker)

If the configured value is invalid (e.g. negative or not a valid number), the system reverts to the default duration of twelve hours.

1. Navigate to your Connectware installation directory. The default installation directory is `/opt/connectware`. This directory contains the `.env` file used when starting Connectware.
2. Open the `docker-compose.yml` file.
3. Set the `CYBUS_AUTH_TOKEN_EXPIRE_TIME_IN_HOURS` environment variable to the desired number of hours.

{% code lineNumbers="true" %}

```yaml
environment:
  - CYBUS_AUTH_TOKEN_EXPIRE_TIME_IN_HOURS=8
```

{% endcode %}

4. Start or restart Connectware. For details, see [Restarting Connectware](/2-1-2/documentation/installation-and-upgrades/restarting-connectware.md).
   {% endtab %}
   {% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cybus.io/2-1-2/documentation/user-management/users/user-session-expiration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.