Access Your Workspace

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.

  1. Open one of the supported web browsers.

  2. Enter the workspace URL in the browser's address bar, such as https://open.rocket.chat.

  3. 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.

  1. Download the Rocket.Chat desktop app for your operating system.

  2. Install and open the app.

  3. The workspace connect screen appears. Enter a valid workspace URL and click Connect.

  4. The login page appears. You can enter your credentials to log in or click Create an account to register as a workspace member.

When using a Rocket.Chat desktop application you can connect to multiple Rocket.Chat workspaces. To add a new workspace, click the plus icon below the workspace list on the left sidebar and continue with the above steps to connect to a new Rocket.Chat workspace.

  1. Download and install the Rocket.Chat app compatible with your mobile operating system.

  2. Open the app. If this is your first time using the mobile app, the workspace connect screen will be displayed.

  3. Click Join a workspace.

  4. Enter a valid workspace address and click Connect.

  5. After entering a valid Rocket.Chat workspace address, click Login.

  6. 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:

  1. Click the title of your current workspace.

  2. Click Add workspace.

  3. 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.

  4. Click Connect to log in to the workspace using your credentials.

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 on 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:

  1. Log in to your workspace using your credentials.

  2. Click your user icon and select Profile from the drop-down menu.

  3. Enter the new password in the New password and Confirm password fields.

  4. 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.