Workspace FAQ

Prev Next

Accessing workspace FAQ

How do I access my Rocket.Chat workspace?

To access your workspace:

  1. Open your browser and enter the URL provided by your workspace administrator. It typically follows this format:
    https://your-workspace-address.rocket.chat

  2. Log in using your username and password.

For step-by-step guidance, see the Access Your Workspace guide.

Can I access my Rocket.Chat workspace on a mobile device?

Yes. Rocket.Chat provides mobile apps for both iOS and Android, available on the App Store and Google Play.

After installing the app, enter your workspace URL and your login credentials to sign in.

Need help? See the Install Desktop and Mobile App guide for installation steps.

I'm having trouble logging in to my Rocket.Chat workspace. What should I do?

If you're unable to log in:

  1. Double-check your workspace URL, username, and password for accuracy.

  2. If you’ve forgotten your password, click the “Forgot your password?” link on the login screen to reset it.

  3. If you still can’t log in, reach out to your workspace administrator for assistance.

Can I switch between multiple workspaces in Rocket.Chat?

Yes, both the desktop and mobile apps allow you to switch between workspaces by adding a new server.

  • Desktop app: Click the plus (+) icon below the workspace list in the left sidebar to connect to a new workspace.

  • Mobile app: Tap the workspace title, select Add workspace, and enter the new workspace URL and your login credentials.

Can I access Rocket.Chat offline?

Rocket.Chat requires an internet connection for real-time messaging. However, previously loaded messages might still be accessible offline due to local caching, depending on your browser or app settings.

Two-factor authentication FAQ

How do I make email two-factor authentication mandatory for a role?

To enforce email-based two-factor authentication (2FA) for a specific role in Rocket.Chat:

  1. Ensure that SMTP is configured and functional in your workspace.

  2. Go to Administration > Workspace > Settings > Accounts and:

    • Enable Two Factor Authentication.

    • Enable Two Factor Authentication via Email.

  3. In the same section, go to Registration, and:

    • Enable Require email verification to login.

  4. Go to Administration > Workspace > Permissions and:

    • For the desired role, click the pen icon to edit the role and enable Users must use Two Factor Authentication.

Note: Role-based enforcement is only available on the Enterprise plan.

When users with the specified role log into the workspace, they will receive an authentication code via email and will be required to enter it before gaining access.

White-labeling FAQ

Rocket.Chat's white-labeling feature lets you customize your workspace to align with your organization’s branding.

How do I change my workspace logo in the server list of the desktop app?

To update the logo shown in the server list of the desktop app:

  1. Go to Administration > Workspace > Settings > Assets.

  2. Upload an SVG format of your logo in the favicon (svg) field.

How do I change my workspace logo in the server list of the mobile app?

To update the logo shown in the server list of the mobile app:

  1. Go to Administration > Workspace > Settings > Assets.

  2. Upload a 512x512 PNG version of your logo in the android-chrome 512x512 (png) field.

Registration FAQ

How do I lock registration on Rocket.Chat?

To disable a new user registration:

  1. Log in to Rocket.Chat account that has administrative privileges.

  2. Go to Administration > Workspace > Settings > Accounts.

  3. Scroll to the Registration section.

  4. You’ll see the Registration Form option, which is set to Public by default. Change it to Disabled , then save your changes.

By setting the registration form to Disabled, no new user registrations will be accepted. Existing users can still log in and use the platform as usual.

Use a Secret Registration URL (optional)

Instead of disabling registration completely, you can limit it to only users who have a secret link:

  1. Set Registration Form to Secret.

  2. Enter a random string in the Registration Form Secret URL field (e.g., my-secret-code) and save your changes.

This will make your workspace registration page accessible only at:
https://yourdomain.com/register/my-secret-code

Admins can share this link manually with users who are allowed to register.

What is user email verification?

Email verification ensures that only users with verified email addresses can log in to your workspace.

To require email verification during registration:

  1. Go to Administration > Workspace > Settings > Accounts

  2. Under the Registration section, enable Require email verification to login.

Once enabled, users must verify their email before logging in.

Workspace admins can also verify a user's email manually:

  1. Go to Administration > Workspace >Users.

  2. Find and edit the user and enable the Mark email as verified toggle.

Make sure your SMTP settings are properly configured so Rocket.Chat can send verification emails.

Message privacy FAQ

Can my workspace administrator view messages in a channel they’re not a member of?

Messages in public channels are visible to all workspace users, including administrators. However, private channels and direct messages are only accessible to their members, unless the workspace has Message Auditor roles enabled.

Users with the Message Auditor role can access all messages (public or private) via the audit panel. Their actions are recorded in Audit Logs, which can be reviewed by other auditors.

For maximum privacy, use end-to-end encrypted (E2EE) or off-the-record messaging, these prevent even auditors from accessing the messages.

File upload FAQ

Why am I getting the "Request Entity Too Large" error when uploading a file?

This error usually means the file you're uploading exceeds the configured upload size limit.

 

Option 1: Check your Rocket.Chat file upload settings

To resolve this, start by checking your Rocket.Chat workspace settings:

  1. Go to Administration > Workspace > Settings > File Upload.

  2. Increase the Maximum File Upload Size if needed.

Option 2: Check your NGINX proxy settings

If you're using NGINX as a reverse proxy, the error may be caused by NGINX’s default limit. Update your NGINX configuration to increase the client_max_body_size value. See the Nginx documentation for more details.

Uploading very large files can also trigger issues with MongoDB’s sort operations. If that happens, follow this guide to troubleshoot.

Notifications FAQ

How do I manage workspace notifications?

Workspace notifications can be customized at different levels: