To access your Rocket.Chat workspace, you need the URL. If you don’t have a link yet, ask your IT or workspace administrator for your organization’s Rocket.Chat URL. You can use this link to access the workspace via a browser, desktop, or mobile app.
Open one of the supported web browsers.
Enter the workspace URL in the browser's address bar, such as
https://open.rocket.chat.After entering a valid Rocket.Chat workspace address, the login page is displayed. Enter your credentials to log in or click Create an account to register as a workspace member.
After you download and install the Rocket.Chat desktop app for your operating system, connect it to your Rocket.Chat workspace.
Connect your workspace
Open the Rocket.Chat desktop app.
Enter your workspace server URL when prompted.
Click Connect.
On the login page, sign in with your existing credentials. If you don't have an account, click Create an account to register as a workspace member.
By default, connected workspaces appear as tabs at the top of the application, allowing you to switch between them. You can change this layout to a sidebar list or a title bar list in the Desktop App Configuration settings.
Connect additional workspaces
When using a Rocket.Chat desktop application, you can connect to multiple Rocket.Chat workspaces.
To add another workspace:
Click the
plus icon next to the current workspace tab.Enter the server URL for the workspace you want to connect to.
Click Connect.
Follow the prompts to sign in or create a new account.
You can switch between connected workspaces using the tabs, sidebar, or title bar, depending on your selected layout.
Manage connected workspaces
Each connected workspace has a context menu with workspace-specific options.
To open the menu, right-click a connected workspace in the sidebar. The following options are available:
Option | Description |
|---|---|
Reload | Refreshes the selected workspace without affecting other connected workspaces. |
Copy Current URL | Copies the URL of the current page in the workspace. |
Open DevTools | Opens the browser developer tools for the selected workspace. |
Server Info | Displays information about the connected server, including its version, URL, and supported versions. This option is available only when Help > Developer mode is enabled from the menu bar. |
Force Reload | Clears the workspace cache and reloads the entire workspace. You’ll be prompted to choose to either keep or delete your current login session. If you delete the session, you’ll be signed out and must sign in again with your credentials to access your workspace. |
Remove | Disconnects and removes the workspace from the desktop app. To access it again, you must add the workspace and sign in again. |
Download and install the Rocket.Chat app compatible with your mobile operating system.
Open the app. If this is your first time using the mobile app, the workspace connect screen will be displayed.
Click Join a workspace.
Enter a valid workspace address and click Connect.
After entering a valid Rocket.Chat workspace address, click Login.
Enter your credentials to log in or click Create an account to become a workspace member.
To add another workspace that you are already part of, follow these steps:
Click the title of your current workspace.
Click Add workspace.
Enter the workspace URL. Select Apply your certificate if you have an SSL certificate on your device. For details, see Supporting SSL for development on Rocket.Chat.
Click Connect to log in to the workspace using your credentials.
If you don’t have a Rocket.Chat workspace yet, refer to the Deployment documentation to learn about your options.
Login options
According to your workspace configuration, you can log in in one of the following ways:
Using email address or username with password.
Using SSO to log in with third-party credentials, such as Google or Microsoft.
Additionally, you may need to enter 2FA codes while logging in using apps like Google Authenticator or Microsoft Authenticator.
Register an account
If you don’t have an account set up, you can register as a user in one of the following ways:
Manual registration: Provide your name, email, username, and password, and confirm the password. Some workspaces may require email verification. The registration credentials may vary based on the workspace configurations. Contact your workspace administrator if you're unsure of how to register your account.
OAuth registration: If your workspace has enabled OAuth services (such as GitHub or Google), you can use your account from those supported services to register and access the workspace. Once you have completed a successful registration, proceed to select a unique username.
Your username serves as a unique identifier for others to direct message or mention you within the workspace. It differs from your display name and must be unique within the workspace, while display names can be duplicated.
Reset your password
If you have forgotten your password, click Forgot your password? and enter the email address associated with your account. You will receive further instructions in your email inbox. Alternatively, contact your workspace administrator for assistance.
If you want to change your current password, follow these steps:
Log in to your workspace using your credentials.
Click your user icon and select Profile from the drop-down menu.
Enter the new password in the New password and Confirm password fields.
Click Save changes. Now you can log in with your new password.
Note that your administrator may have disabled the option to change passwords. In that case, you must contact your administrator.
/tab