Deploy on Cloudron

Prev Next

The recommended deployment methods are Docker and Kubernetes. Using other deployment methods may result in unexpected challenges or compatibility issues.

Cloudron is a complete solution for running apps on your server while keeping them up-to-date and secure. This document will walk you through deploying Rocket.Chat on Cloudron.

Prerequisites

Before you begin, ensure you have the following:

  • Domain name (e.g., example.com)

  • Cloud server running Ubuntu (or a virtual environment on AWS, VMware, etc.)

  • An active Cloudron.io account

Step 1: Install Cloudron on your server

To install Cloudron, you need a server with a clean Ubuntu installation. Once your server is ready:

  1. Open a terminal and run the commands provided in the Cloudron documentation.

  2. The installation may take a few minutes. Once complete, you will be prompted to reboot the server.

  3. After rebooting, access the Cloudron setup page by navigating to the URL provided in the installation output.

Your browser may display a warning about an untrusted certificate. Click on Advanced and proceed to accept the self-signed certificate.

Step 2: Configure Cloudron

  1. On the Cloudron setup page, enter your domain name.

  2. Choose your DNS provider and enter the required details.

  3. Click Next to register and propagate the domain. This process may take a few minutes.

  4. Once the process is complete, Cloudron will be accessible at my.<your-domain.com>.

Step 3: Set up an admin account

  1. Once the domain is set up, you will be prompted to create an admin account for Cloudron.

  2. Provide your name, email (must be valid for Let's Encrypt SSL certificates), username, and password.

  3. Click Save and proceed to access the Cloudron dashboard.

Step 4: Install Rocket.Chat from the Cloudron App Store

  1. Navigate to the Cloudron dashboard (e.g., my.example.com).

  2. Click on App Store and search for the Rocket.Chat app. You may be prompted to login to your Cloudron.io account.

  3. Select the app and Install.

  4. Choose a subdomain for your Rocket.Chat instance:

    1. If your domain is example.com and you enter rocketchat, the URL will be rocketchat.example.com

    2. Leave it blank to install Rocket.Chat at the root domain

  5. Select the appropriate user management option.

  6. Click Install and wait for the installation to complete.

Step 5: Access Rocket.Chat

  1. Once installation is complete, the Rocket.Chat app will show a Running status.

  2. Click the app to launch the application in your browser.

  3. Your Rocket.Chat instance will now be available at https://rocketchat.example.com, if you chose rocketchat as the subdomain for the domain example.com .

Congratulations! You have successfully deployed Rocket.Chat on Cloudron.

Next steps

Once you’ve successfully created your Rocket.Chat workspace and logged in. Next, check out the following documents to get started:

  • User Guides: Learn the basics of your Rocket.Chat account, the types of rooms, and how to communicate with your workspace users.

  • Workspace Administration: Administrators and owners can set and manage various configurations.

  • Marketplace: Explore the available apps to enhance your workspace

Follow this document to learn more about using Rocket.Chat on Cloudron. There is a demo at https://my.demo.cloudron.io (username: cloudron password: cloudron).