Rocket.Chat
Rocket.Chat
by Rocket.Chat

VERSION 1.1.1

OS Ubuntu 18.04

Create Rocket.Chat Droplet

Description

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

Software Included

PackageVersionLicense
Rocket.Chat1.1.1MIT
MongoDB4.0.3AGPL
NodeJS8.11.4MIT

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

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.

 To configure your Rocket.Chat service:

 1. Open the Rocket.Chat service file /lib/systemd/system/rocketchat.service using sudo and your favourite text editor
 2. Change the ROOT_URL environmental variable to reflect the URL you want to use for accessing the server from the Internet (optionally change MONGO_URL and PORT)

 Looking for how to use Rocket.Chat? Be sure to check our docs: https://rocket.chat/docs
 Need some help? Join our community forums https://forums.rocket.chat

Remember to restart Rocket.Chat service after changing ROOT_URL:
systemctl daemon-reload && systemctl restart rocketchat.service

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

Setting up HTTPS

We would recommend adding a loadbalancer in to handle HTTPS.

A few options to do this:

  1. Use DigitalOcean Load Balancer
  2. Install your own - see here for more infoIf you want to use DigitalOcean Load Balancer goto: https://www.digitalocean.com/docs/networking/load-balancers/quickstart/

Our recommended settings are:

Forwarding Rules:

Protocol Port Cert Droplet Protocol Droplet Port
HTTP 80 HTTP 3000
HTTPS 443 Lets Encrypt HTTP 3000

Under Advanced settings:

Health checks:

Protocol Port Path
HTTP 3000 /api/info

Check 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"
      

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