Deploy Rocket.Chat

Rocket.Chat gives you full control over how and where you deploy your workspace. You can choose between a self-managed setup, a quick cloud hosted launch, or a secure air-gapped environment for sensitive deployments. From small teams to large enterprises with strict compliance needs, Rocket.Chat supports a wide range of deployment scenarios. This documentation covers the different ways you can deploy Rocket.Chat, whether you're setting up a new workspace or migrating from another platform. It includes setup guides, scaling strategies, and directory integration options to help you align Rocket.Chat with your organization’s infrastructure.

  1. Cloud Hosting Services: Leverage our cloud hosting service to launch your workspace quickly without handling infrastructure. Review Rocket.Chat’s Cloud Hosting Service Level Agreement for details on hosting tiers, support coverage, and service availability.

  2. Deploy self-managed workspaces: Explore our range of deployment options to manage Rocket.Chat on your own infrastructure. This option offers complete control over configuration, scaling, and infrastructure management based on your team’s technical requirements.

  3. Deploy air-gapped workspaces: Rocket.Chat supports fully air-gapped deployments for high-security environments that require strict data control. Ideal for sectors like government, defense, and regulated industries, this option allows you to run Rocket. Chat with no internet access while maintaining full functionality within the isolated environment.

  4. Scaling Rocket.Chat: Rocket.Chat is built to scale from small teams to large, distributed organizations. You can run multiple Docker instances or adopt a microservices architecture with Kubernetes to support high availability, load balancing, and increased performance as your usage grows.

  5. Data migration tools: Bring your team’s data with you. Use our diverse tools to migrate users, messages, and content from platforms like Slack and HipChat, so you can transition smoothly without losing context.

  6. Directory Integration: Integrate Rocket.Chat with your organization’s Active Directory using LDAP to centralize user management and streamline access control while ensuring secure transmission of sensitive information.

Deploy a self-managed workspace

You can deploy a self-managed Rocket.Chat workspace using different options, which we will explore extensively in this section. Furthermore, we will discuss system requirements, optimization, and top-notch security measures for seamless deployment.

Prerequisites

Follow the System Requirements guide to deploy a successful and stable Rocket.Chat workspace. Select the appropriate system specifications for hardware, file storage, and MongoDB for your workspace.

Recommended deployment methods

The following modes of deployment are recommended for the production environment :

  • Deploy with Docker & Docker Compose: Install and set up Rocket.Chat with Docker & Docker compose.

  • Deploy with Kubernetes: Use the official Rocket.Chat Helm chart with Kubernetes.

  • Deploy with Snaps: Snaps are also a convenient way to rapidly deploy a Rocket.Chat instance for development or discovery purposes. However, we do not recommend Snaps for managing the production environment.

  • Deploy with AWS: Deploy Rocket.Chat with an EC2 AMI from the AWS marketplace.

If you are using a firewall, you may need to whitelist some URLs to communicate with our cloud services. See Firewall Configuration for the complete list.

Update Rocket.Chat

Once your workspace is deployed, learn how to update Rocket.Chat to the latest version or your preferred release. For additional information about the releases, visit our release page.

Scale Rocket.Chat

You can scale Rocket.Chat workspaces to ensure optimal performance even with thousands of users and more. You can do this by deploying Rocket.Chat using microservices or several smaller components, each focusing on a single feature of Rocket.Chat.

Additional deployment methods

Find additional methods to deploy and test your workspaces:

Encountering any issues with your deployment? See the Deployment FAQ guide for more details.

As of December 15, 2023, Rocket.Chat has ceased support for connections from cloud services and official mobile/desktop apps to workspaces running legacy versions outside our support window. Users on unsupported legacy servers are advised to upgrade to the latest Rocket.Chat version to ensure continued access to cloud, mobile, and desktop applications. Each Rocket.Chat version is supported for six months post-release.