The Rocket.Chat desktop application provides centralized settings to customize app behavior, manage certificate trust, configure calling preferences, and access developer diagnostics.
To open the settings panel:
Open the Application menu by clicking the three-dot icon in the top bar or at the bottom of the left sidebar, depending on your workspace layout.
Select App Settings.
Alternatively, on macOS, you can use the Cmd + , keyboard shortcut to access these settings.
The settings panel is organized into four main tabs:
General: Configure the app's appearance, window behavior, notifications, browser preferences, and other general options.
Certificates: Review and manage trusted or rejected SSL/TLS certificate exceptions.
Voice and Video: Configures default audio, telephony shortcuts, and in-app calling preferences.
Developer: Provides advanced logging controls for system diagnostics and integration troubleshooting.
General settings
The General tab controls the desktop app's core behavior and appearance.
Setting | Description |
|---|---|
Theme | Choose the color theme for your desktop app. The available options are:
|
Workspace switcher | Choose how your connected workspaces should be displayed. The available options are:
|
Transparent window effect | Enable the native vibrancy and transparency effect for the desktop app window. The app will automatically restart to apply your changes when this option is enabled or disabled. |
Menu bar extra | Show app icon in menu bar. |
Bounce dock icon | Bounce the app icon in the dock to draw your attention when new notifications arrive. |
Download percentage | Display the download progress as a percentage in the tab bar while a file is downloading. |
Default Browser | Choose which browser opens external links from the app. The available options are:
|
Outlook Calender Sync Interval | Set how frequently (in minutes) Outlook syncs calendar events. |
Hardware Acceleration | Enables hardware acceleration when available. The app will reload when it detects a change. |
PDF preview size limit in encrypted rooms (MB) | Set the maximum file size (in MB) for generating previews of encrypted PDF files. PDF files larger than this limit will be downloaded directly instead of previewed. |
Report errors to Rocket.Chat | Send error reports to the developers to help improve the app. If you installed the app from the Mac App store, this option is disabled and errors are reported through the Mac App Store report process. |
Setting | Description |
|---|---|
Report errors to developers | Send error reports to the developers to help improve the app. On Windows, this option is enabled by default. |
Enable Flash Frame | Flash the window to attract the user's attention when new alerts arrive. |
Hardware Acceleration | Enables hardware acceleration when available. The app will reload when it detects a change. |
Fallback Screen Capture for Video Calls | Disable Windows Graphics Capture to enable screen sharing in Remote Desktop sessions. The app restarts when you change this option. |
Open Video Chat in Application Window | Enable this option to open video chats directly within the desktop app window. |
Remember video call window position | Save and restore the size and position of video call windows between sessions, so they reopen exactly as you left them. |
Tray Icon | Enable the tray icon for the desktop app to control how the application behaves when you close it. When this option is enabled, closing the app does not fully quit it but continues running in the background and is hidden in the system tray. You can reopen the app at any time from the tray icon. When this option is disabled, closing the app will completely quit Rocket.Chat, and it will no longer run in the background. On Windows, the tray icon is located in the notification area at the bottom-right corner of your taskbar. Right-click the Rocket.Chat icon to show, hide, or quit the application. |
Minimize on close | With this option enabled, the app will be minimized when closed and continue running in the background. When this option is disabled, the app quits when closed. When the Tray Icon setting is enabled, this setting is enabled by default. If the Tray Icon setting is disabled, this setting can be changed. |
Sidebar | Display the sidebar on the left side of the desktop app window to access your list of workspaces. |
Menu bar | Display the menu bar at the top of the desktop application to access key controls. Note that both the Sidebar and the Menu bar cannot be disabled at the same time. At least one option must be enabled. |
NTLM Credentials | Allow NTLM credentials to be used when connecting to a server. When this option is enabled, you can enter the domains (as comma-separated values) that will use the credentials. Use |
Theme | Choose the color theme for your desktop app. The available options are:
|
Default Browser | Choose which browser opens external links from the app. The available options can include:
|
Outlook Calender Sync Interval | Set how frequently (in minutes) Outlook syncs calendar events. By default, the value is 60. |
PDF preview size limits in encrypted rooms (MB) | Set the maximum size of encrypted PDF files that can be previewed. Files larger than this limit are downloaded directly instead of being previewed. |
Clear Screen Capture Permissions | Removes all screen capture permissions previously granted to workspaces. After clearing, the app prompts for permission again the next time a workspace requests screen capture access. |
Certificate settings
The Certificates tab shows how the desktop app has handled invalid SSL/TLS certificates encountered when connecting to servers or loading workspace content. When the app encounters an invalid certificate (for example, self-signed or expired), it prompts you to trust or reject it. Your choice is recorded in this tab for later review or modification. You can remove a domain from either list, and the app will prompt you again the next time it encounters that domain's certificate.
Trusted Certificates: Domains with invalid certificates that you chose to trust. The app will connect to these domains without further warnings.
Not Trusted Certificates: Domains with invalid certificates that you chose not to trust. The app will block connections to these domains.
Valid certificates are accepted automatically and do not appear here. This tab only tracks decisions made for certificates flagged as invalid.
Voice and Video settings
The Voice and Video tab controls how the desktop app handles telephony shortcuts and video calls.
Telephony
Use the telephony settings to control how Rocket.Chat handles phone-call shortcuts and links.
Setting | Description |
|---|---|
Telephony | Allow Rocket.Chat to handle phone-call shortcuts and |
Global call shortcut | Press this shortcut from any app to bring Rocket.Chat to the front and open the dial pad. If a phone number is on your clipboard, it gets pre-filled. |
Video calls
Setting | Description |
|---|---|
Video calls inside app | Configure video calls to always open inside the desktop app. This option is disabled when installed from the Mac App Store. For security reasons, video calls always open in the browser by default. |
Retain video call window position | Save and restore the size and position of video call windows between sessions, so they reopen exactly as you left them. |
Developer settings
The Developer tab is displayed when the Developer mode is enabled in the app. Enable the Developer mode from the Help drop-down menu in the top menu bar.
The following logging settings are available in the Developer tab:
Setting | Description |
|---|---|
Verbose Logging | When this option is enabled, all console outputs are written to the log file. When this option is disabled, only errors and important messages are saved, keeping logs smaller and focused. |
Verbose Outlook Calendar Logging | Enable detailed Exchange/NTLM debug logs for troubleshooting Outlook Calendar integration issues. |
Detailed Events Logging | Enable this option to log full event data exchanged between Outlook and Rocket.Chat during calendar sync. This is useful for diagnosing sync issues. |