Rocket.Chat
Rocket.Chat
by Rocket.Chat

VERSION 2.1.0

OS Ubuntu 18.04

Create Rocket.Chat Droplet
đź’µ Free credit active: You have a $50, 30-day credit from a friend. Create your first Droplet to get started.

Description

Rocket.Chat is free, unlimited and open source. Replace email, HipChat & Slack with the ultimate team chat software solution.

Software Included

PackageVersionLicense
Rocket.Chat2.1.0MIT
MongoDB4.0.3AGPL
NodeJS8.15.1MIT
Traefik1.7.12MIT

Getting started after deploying Rocket.Chat

Thanks for installing Rocket.Chat!

You'll likely want a registered domain name to access Rocket.Chat.

We recommend setting up an A record from your domain to your servers IP address. Ex: chat.mycompany.com

Rocket.Chat will not work with HTTPS out of the box because certificates are unique for each installation, but with this setup HTTPS will be available using Let's Encrypt certificates.

After the Rocket.Chat One-Click is finished and your domain is setup. You will need to login to your droplet to finish setup.

ssh root@your_droplet_ip

Once you are connected you should see something like:

Rocket.Chat is the leading open source team chat software solution. Free, unlimited and completely customizable with on-premises and SaaS cloud hosting.
Replace email, HipChat & Slack with the ultimate team chat software solution.

  Out of the box you can access Rocket.Chat server at: http://Droplet-IP:3000

 You will likely want a registered domain name to access Rocket.Chat. If you would like your server to be accessible over https we provide the option to use letsencrypt by running:
  # rocketchatctl configure --lets-encrypt --root-url=https://chat.yourcompany.com --letsencrypt-email=admin@yourcompany.com

 In case you do not own a registered domain, you could use the public IP of your droplet, but traefik will not be able to fetch certificates for you so you will see a privacy alert message when loading https://droplet-IP
  # rocketchatctl configure --lets-encrypt --root-url=https://droplet-IP --letsencrypt-email=admin@yourcompany.com

 If you would like https with something other than letsencrypt provided certificates you will have to manually edit the traefik config to add it.

 In case you do own a registered domain, but you do not want to use traefik, you can just configure your site URL running:
  # rocketchatctl configure --rocketchat --root-url=http://chat.yourcompany.com:3000

 Keep your RocketChat server updated using rocketchatctl update. Run rocketchatctl -h to see the full list of available options.

 Looking for how to use Rocket.Chat? Be sure to check our docs: https://rocket.chat/docs

 Checkout our Digital Ocean docs: https://rocket.chat/docs/installation/paas-deployments/digital-ocean/

 Need some help? Join our community forums https://forums.rocket.chat

Out of the box you can access Rocket.Chat server at: http://Droplet-IP:3000

Setting up HTTPS

We recommend you to finish the Traefik loadbalancer configuration to handle HTTPS. Run this command to fetch Let's Encrypt certificates for your installation:

rocketchatctl configure --lets-encrypt --root-url=https://chat.yourcompany.com --letsencrypt-email=admin@yourcompany.com

You can then access at: https://chat.yourcompany.com replacing chat.yourcompany.com with the address you set in your DNS.

The Loadbalancer will redirect HTTP to HTTPS

API Creation

In addition to creating a Droplet from the Rocket.Chat 1-Click App via the control panel, you can also use the DigitalOcean API.

As an example, to create a 4GB Rocket.Chat Droplet in the SFO2 region, you can use the following curl command. You’ll need to either save your API access token to an environment variable or substitute it into the command below.

curl -X POST -H 'Content-Type: application/json' \
     -H 'Authorization: Bearer '$TOKEN'' -d \
    '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image":"rocketchat-18-04"}' \
    "https://api.digitalocean.com/v2/droplets"

API Creation

In addition to creating a Droplet from the Rocket.Chat 1-Click App via the control panel, you can also use the DigitalOcean API.

As an example, to create a 4GB Rocket.Chat Droplet in the SFO2 region, you can use the following curl command. You’ll need to either save your API access token to an environment variable or substitute it into the command below.


  curl -X POST -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer '$TOKEN'' -d \
      '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image":"rocketchat-18-04"}' \
      "https://api.digitalocean.com/v2/droplets"
      

Support Details

Supported By:Rocket.Chat
Support URL:https://forums.rocket.chat
Support Email:support@rocket.chat

Learn More

Product Docs

Technical overviews, how-tos, release notes, and support material

Tutorials

DevOps and development guidelines

API Docs

Run your resources programmatically

Ask a question

Connect, share and learn