Admin Onboarding Overview

Prev Next

This guide is your starting point as a new Rocket.Chat administrator. It lists every step to set up your workspace, in the order to do them, and links to the full instructions for each step.

By the end, your workspace is set up, secured, branded, and ready for your users.

Before you begin

  • Self-managed workspaces: Your workspace must already be deployed. For instructions, see Deploy Rocket.Chat.

  • Cloud-hosted workspaces: Rocket.Chat deploys the workspace for you. You need your workspace URL, which you can find in your Rocket.Chat Cloud account.

You can complete every step in a web browser or the desktop app. In the mobile app, you can manage most settings through Admin panel, but the setup wizard isn't available.

Your setup checklist

Follow the checklist for your deployment type.

Self-managed

  1. Access your workspace as admin: Open your workspace and sign in. For instructions, see Access Your Workspace as Admin.

  2. Complete the setup wizard: Create your admin account, enter your organization details, and register the workspace. For instructions, see Complete the Setup Wizard.

  3. Choose your plan: New workspaces start on the Starter plan. To upgrade to a premium plan, see Subscribe Your Workspace. To apply a license key or check your plan, see Manage Subscription and License.

  4. Secure sign-up and sign-in: Decide who can create an account, and review the password and two-factor authentication settings. For instructions, see Secure Sign-up and Sign-in.

  5. Configure email: Connect your SMTP server, so the workspace can send invitations and verification emails. For instructions, see Configure Email.

  6. Brand your workspace: Add your logo, colors, and login screen. For instructions, see White-labeling & Customizing Your Workspace.

  7. Add users: Invite users by email, add them manually, import them, or connect LDAP or SSO. For instructions, see Add Users to Your Workspace.

  8. Help your users connect: Point your users to the guides for signing in, installing the apps, and setting up their accounts. For instructions, see Help Your Users Connect.

If you need to register your workspace again later, for example after a migration, see Manage Workspace Registration.

Cloud-hosted

Rocket.Chat registers your workspace, applies your license, and configures email before handing the workspace over to you, so your checklist is shorter:

  1. Access your workspace as admin: Open your workspace and sign in. For instructions, see Access Your Workspace as Admin.

  2. Check your plan: Confirm your plan and seats. For instructions, see Manage Subscription and License.

  3. Secure sign-up and sign-in: Decide who can create an account, and review the password and two-factor authentication settings. For instructions, see Secure Sign-up and Sign-in.

  4. Turn on email verification (optional): Email already works, so you can require users to verify their email address. For instructions, see Step 3 of Configure Email.

  5. Brand your workspace: Add your logo, colors, and login screen. For instructions, see White-labeling & Customizing Your Workspace.

  6. Add users: Invite users by email, add them manually, import them, or connect LDAP or SSO. For instructions, see Add Users to Your Workspace.

  7. Help your users connect: Point your users to the guides for signing in, installing the apps, and setting up their accounts. For instructions, see Help Your Users Connect.

Need help?

For answers to common questions, see Workspace FAQ.