Desktop Changing Default Settings

After successfully setting up your Desktop App, you have the option to change the app's default settings. In this guide, you'll learn how to customize various settings in the ROcket.Chat Desktop app.

You are required to have basic knowledge of Git, Node, Javascript, and Electron.


Commonly, the primary adjustment is altering icons. Some specific folders in your root project directory where assets can be customized include:


Take extra caution as these files are React components, ensure to modify them correctly. When the changes are done, generate your new files by running this command:

yarn build-assets

Tray Icon

If you want to customize the TrayIcon, there are two ways:

  • Open public/images/tray there you can check all current icons used by the application. You can change files if you want.

  • Open and change ui/icon/AppIcon.tsx this is the icon base used to automatically generate all the icons, if you are used with tsx/jsx probably this is the easiest way to go.

For customizing the TrayIcon, you have two options:

  1. Navigate to public/images/tray to review and potentially modify the icons used by the application. You can replace files as desired.

  2. Alternatively, open and modify ui/icon/AppIcon.tsxfile. It is the icon base used to automatically generate all the icons. If you're familiar with tsx/jsx, this might be the more straightforward approach to take. After making the changes, run this command:

yarn build-assets


To change the About screen, navigate to ./src/ui/components/AboutDialog/index.tsx where you can change the copyright. If you've changed the logo already, it will automatically reflect on this page.

const copyright = `© 2016-${new Date().getFullYear()}, Rocket.Chat`;

Building and Packaging

We use electron-builder to "compile" and produce the executable files. To make any updates, check the file electron-builder.json. Update all references to the term based on the context of each setting.

See the electron-builder configuration guide for more details.

To maintain automatic updates, see the electron-builder publish guide.

After making any change in the configuration, build a new release by running these commands:

yarn build
yarn release

See the GitHub repository for more information on configuring CI/CD.

Last updated

Rocket.Chat versions receive support for six months after release.