---
title: Settings
description: General, AWS, Appearance, About, and Advanced settings.
---

![Settings dialog, General tab](/screenshots/settings-general.png)

| Tab | Setting | Meaning |
| --- | --- | --- |
| General | Terminal | Terminal app for **Open terminal**. Auto-detect by default |
| General | Keep running in the tray | Hide the window on close instead of quitting |
| General | Start at login | Open rolle when you sign in to this computer. Not available from the Linux AppImage |
| General | Expiry notifications | System notification before a session expires and when it does, and the tray's amber flag. The notification's button starts the session again |
| General | Warn before a session expires | 2, 5, 10, or 15 minutes. The tray flags the session for the same time |
| General | Automatic updates | Check for a signed update every six hours and install it |
| AWS | Default region | Pre-fills the region for new AWS sessions. `us-east-1` by default |
| AWS | Assume role duration | Requested STS `AssumeRole` duration in minutes for chained sessions. 60 by default. Identity Center roles use their permission set's duration |
| AWS | Profiles in ~/.aws/credentials | Lists the profiles in `~/.aws/credentials` that hold static keys and removes them. Shows only when the file holds some |
| Appearance | Theme | System, light, or dark |
| Appearance | Dock icon | macOS only. Off takes rolle out of the Dock; the tray icon stays |
| Appearance | Dock badge | macOS and Windows. The number of sessions and sign-ins about to expire, on the app icon. Independent of expiry notifications |
| Appearance | Sidebar sections | Show or hide AWS Identity Center, AWS IAM, Azure tenants, and Google Cloud in the sidebar. Sessions of a hidden section still show under All sessions |
| About | Check for updates | Check now and install a newer version |
| About | Update channel | Stable follows the latest release. Beta follows the newest release including pre-releases |
| Advanced | Verbose logging | Same as `ROLLE_DEBUG=1` |
| Advanced | HTTPS proxy | One proxy for every request. Empty follows `HTTPS_PROXY` |
| Advanced | Extra CA bundle | PEM file added to the OS trust store, for TLS inspection roots |
| Advanced | Replay onboarding | Runs the onboarding flow again |
| Advanced | Reset | Removes every session, integration, secret, and cached credential |

Settings live in the workspace file and apply to the CLI.