Rocket.Chat Server Setup

Article Outline
  1. 1. About Rocket.Chat
    1. 1.1. 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] can be setup as a self-hosted and self managed solution. 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]


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 server:
  • sudo snap install rocketchat-server
  1. Verify that the 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
    • Your Rocket.Chat server should be up and running
  1. Install terminal multiplexer (tmux):
  • sudo apt-get install tmux
  1. Download/unzip ngrok:
  • curl -o
  • unzip
  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


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 mobile app.

  1. - Pricing ↩︎

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