RocketChatCTL

rocketchatctl is a command line tool written in bash to help you install and configure a RocketChat server in a Linux host, it will take care of everything needed for the server to run, configure extra repositories and install needed libraries to install the correct node version and mongo server, and it will also set up directories and permissions, and configure the systemd files for these new services.
Once you have your rocketchat server installed and running, you can use the same command to easily keep that Rocketchat server installation up to date, rocketchatctl can check for Rocketchat updates available and update it to the latest release.
Furthermore, rocketchatctl optionally installs a loadbalancer/proxy with auto SSL provided by Let's Encrypt.
Check it out here: https://github.com/RocketChat/install.sh​
Environment
Currently, rocketchatctl is supported in these Linux distributions:
Supported OS:
Ubuntu 18.04, 19.04, 20.04
CentOS 7, 8
Debian 9, 10, 11
rocketchatctl automatically install the latest supported node and mongodb versions (CentOS support WIP).
We understand that some users could already have node, mongo, or even a webserver already installed in their servers, rocketchatctl install will check for previously installed versions of node and mongo in your system.
Options and flags
Run rocketchatctl help and check options and flags:
1
rocketchatctl command line tool to install and update RocketChat server
2
​
3
Usage: rocketchatctl [options] [--root-url=ROOT_URL --port=PORT --letsencrypt-email=EMAIL --webserver=WEBSERVER  --version=VERSION --install-node --use-mongo]
4
Installs node, mongo, RocketChat server and optionally a webserver (Caddy or Traefik), sets up directories and permissions to use Let's Encrypt certificates.
5
In case node or mongo already installed, it uses already installed versions though confirmation is required.
6
For node it set v8.11.4 as default in your system, for mongo mmapv1 storage engine and no authentication enabled is required during installation.
7
If you wish this script to run unattended, provide extra flags to the install option, server URL is required (--root-url).
8
​
9
OPTIONS
10
  -h help                   Display this message
11
  install                   Install latest RocketChat server version
12
  update                    Update RocketChat server from current version to latest version
13
  check-updates             Check for updates of RocketChat server
14
  upgrade-rocketchatctl     Upgrade the rocketchatctl command line tool.
15
​
16
FOR UNATTENDED INSTALLATION
17
  --root-url=ROOT_URL       the public URL where RocketChat server will be accessible on the Internet (REQUIRED)
18
  --port=PORT               port for the RocketChat server, default value 3000
19
  --webserver=WEBSERVER     webserver to install as reverse proxy for RocketChat server, options are caddy/traefik/none (REQUIRED)
20
  --letsencrypt-email=EMAIL e-mail address to use for SSL certificates (REQUIRED if webserver is not none)
21
  --version=VERSION         RocketChat server version to install, default latest
22
  --install-node            in case node installed, sets node to RocketChat server recommended version, default behavoir cancel RocketChat server installation
23
  --use-mongo               in case mongo installed, and storage engine configured is mmapv1, skip mongo installation but uses systems mongo for RocketChat server database, default database name rocketchat
Copied!
How to use it
Install Rocket.Chat
You can run rocketchatctl install directly curling the install.sh script from our website, install.sh will download rocketchatctl save it in /usr/local/bin and call rocketchatctl with the install option, this installation will be interactive:
1
bash -c "$(curl https://install.rocket.chat)"
Copied!
In case you want to have an unattended install, use unattended install flags with install.sh script like this:
1
bash -c "$(curl https://install.rocket.chat)" -s --root-url=https://www.example.com --webserver=traefik --letsencrypt-email=[email protected]
Copied!
If you already have rocketchatctl installed just run:
1
rocketchatctl install
Copied!
Or if you want to use your mongo server, change node to the current needed version for Rocket.Chat, listen in a different port, and install another release, you can for example use these command:
1
rocketchatctl install --root-url=https://www.example.com --webserver=none --use-mongo --install-node --port=4000 --version=3.9.0
Copied!
Update Rocket.Chat
Check for release updates:
1
rocketchatctl check-updates
2
Current update available for RocketChat server: from 3.8.0 to 3.9.0
Copied!
And update to the latest release:
1
rocketchatctl update
Copied!
The update option creates a temporary backup directory, download the latest rocketchat release, starts it and checks that is healthy querying the info api. In case something goes wrong in the startup process, the previous installed version from backup is resotored and a error message is displayed.
Upgrade rockectchatctl
This option will download the latest version available for rocketchatctl in the install repo, compare it to your current rocketchatctl and upgrade to the latest version if needed, be sure to check that you are running the latest rocketchactl.
1
rocketchatctl upgrade-rockectchatctl
Copied!
Use rocketchatctl to automate your previously Rocket.Chat manual installation deployments !
Check out our webinar about it here:

Snap FAQ

Kubernetes with Helm

Last modified 1mo ago

Export as PDF

Copy link

Contents

Upgrade rockectchatctl