Rocket.Chat Server Setup


Article Outline
  1. 1. About Rocket.Chat
    1. 1.1. Rocket.chat features:
  2. 2. Self-hosted Server Setup [2]
    1. 2.1. Prerequisites
    2. 2.2. Rocket.Chat Server Installation
    3. 2.3. Publish your Rocket.Chat server to the internet using ngrok [2:1]
    4. 2.4. Conclusion

About Rocket.Chat

Rocket.Chat is an open source communication platform that provides a team-chat interface with features and plugins to facilitate collaboration.[1]

Rocket.chat can be setup as a self-hosted and self managed solution.

Rocket.chat features:

  • Up to 1k Users (recommended)
  • Unlimited Message History
  • 10.000 Monthly Push Notifications
  • Omnichannel Basic (Livechat included)
  • LDAP Basic Sync
  • End-to-End Encryption
  • Customizable User Permission
  • Guest Users

Self-hosted Server Setup [2]

Prerequisites

Rocket.Chat Server Installation

  1. Perform system updates:
  • sudo apt-get update && sudo apt-get dist-upgrade -y
  1. Install the snap daemon:
  • sudo apt-get install snapd
  1. Install rocket.chat server:
  • sudo snap install rocketchat-server
  1. Verify that the rocket.chat server is started:
  • The chat server should be running on port 3000.
  • Point a browser on the same network as the Pi to http://<server ip>:3000
    • You should be able to access the Rocket.Chat server.
    • If the server is not running, run the following command and try again:
      • sudo snap start rocketchat-server
  • Once you are able to access the server you should be promp[ted to create the first user, which will become the server’s adminsitrator.

Publish your Rocket.Chat server to the internet using ngrok [2:1]

  • Requirements:
    • Create a free-tier account from https://ngrok.com/
    • Your Rocket.Chat server should be up and running
  1. Install terminal multiplexer (tmux):
  • sudo apt-get install tmux
  1. Download/unzip ngrok:
  • curl https://bin.equinox.io/c/4VmDzA7iaHb/ngrok-stable-linux-arm64.zip -o ngrok.zip
  • unzip ngrok.zip
  1. Configure ngrok:
  • ./ngrok authtoken <login to obtain auth token>
  1. Run new tmux session window:
  • tmux new -s session
  1. Use ngrok to publish access to your running chat server:
  • ./ngrok http 3000
    • The output from this command should display a custom URL for accessing your server.
    • Copy this URL. This is how you will access the chat server.
  1. Detach from the tmux session window and logout:
  • (Ctrl + b) + d will return you to the main terminal.
  • exit

Conclusion

Rocket.Chat should now be running and accessible via the public URL provided by the ngrok service. You can also use this URL to connect using the Rocket.chat mobile app.


  1. Rocket.chat - Pricing ↩︎

  2. Rocket.chat - Github - Raspberry Pi Setup ↩︎ ↩︎