# Install RocketChat RocketChat is an open source, self hostable chat application that rivals the likes of Teams and Slack. It allows administratos incredible power in permissions and role setup, Room / Channel setup and organization, private / public channels, private group discussions, private 1 to 1 chats, audio / video integration with systems like Jitsi Meet, and so much more. As a business, particularly in the tech service industry, your communication internally as well as with clients is key to success. A system like RocketChat can open communication avenues for you, your team, and your clients to have fast, live-time interactions. #### What You'll Need - A server to run Rocketchat On (ideally running Linux) - Docker / Docker Compose installed - A domain / sub-domain for your chat system to be reached on - A Reverse Proxy - About 30 minutes of your time. ### Installation via a Simple Script You can easily install Docker-CE, Docker-Compose, Portainer-CE, and NGinX Proxy manager by using this quick install script I created and maintain on Github. Just use the command: `wget https://gitlab.com/bmcgonag/docker_installs/-/raw/main/install_docker_nproxyman.sh` To download the script to your desired host. Change the permissions to make the script executable: `chmod +x ./install_docker_nproxyman.sh` and then run the script with the command: `./install_docker_nproxyman.sh` When run, the script will prompt you to select your host operating system, then will ask you which bits of software you want to install. Simply enter 'y' for each thing you want to install. At some point, you may be asked for your super user (sudo) password as well. Allow the script to complete installation. At this point, you might want to log out and back in, as this will allow you to use the `docker` and `docker-compose` commands without the need of sudo in front of them. #### Install RocketChat First, we need to download two files. The docker compose file (compose.yaml) and the example .env file they provide. We can do that with the wget tool in our terminal. Let's make a directory for our RoacketChat install and move into it `mkdir -p docker/rocketchat` `cd docker/rocketchat` Now we can download the two files into our rocketchat directory. ```bash wget https://raw.githubusercontent.com/RocketChat/Docker.Official.Image/master/compose.yml -O compose.yaml wget https://raw.githubusercontent.com/RocketChat/Docker.Official.Image/master/env.example -O .env ``` Next, we need to set some of the environment variables to be specific to our needs for this RocketChat instance. We can edit the .env file using the nano editor in the terminal, or you can edit it with any text editor you prefer. `nano .env` Inside the .env file we need to uncomment a few lines. To do this, we remove the hastag (pound sign, number sign) at the beginning of the lines we need to edit. See my cleaned up example below and make yours look similar. ```yaml ### Rocket.Chat configuration # Rocket.Chat version # see:- https://github.com/RocketChat/Rocket.Chat/releases #RELEASE= # MongoDB endpoint (include ?replicaSet= parameter) #MONGO_URL= # MongoDB endpoint to the local database #MONGO_OPLOG_URL= # IP to bind the process to #BIND_IP= # URL used to access your Rocket.Chat instance ROOT_URL=https://chat.. # Port Rocket.Chat runs on (in-container) PORT=3000 # Port on the host to bind to HOST_PORT=3000 ### MongoDB configuration # MongoDB version/image tag MONGODB_VERSION=5.0 # See:- https://hub.docker.com/r/bitnami/mongodb ### Traefik config (if enabled) # Traefik version/image tag #TRAEFIK_RELEASE= # Domain for https (change ROOT_URL & BIND_IP accordingly) #DOMAIN= # Email for certificate notifications #LETSENCRYPT_EMAIL= ``` In the file above I have removed the hashtag in front of the lines for ROOT\_URL, PORT, HOST\_PORT, and MONGODB\_VERSION. You should do the same. If you use the Traefik reverse proxy, uncomment and fill in those items as well. I use Nginx Proxy Manager, so those can remain commented out. For ROOT\_URL you should enter the url you want users to access the site from. For instance I set mine to "https://chat.sysmainit.com". PORT and HOST\_PORT can both be set as 3000 unless you already have something running on port 3000 on the system, in which case you should change HOST\_PORT to some other port, and then make sure to use that port number in your reverse proxy setup. Once you've made the necessary changes, you can save the file with CTRL + O, then press Enter to confirm, and finally close the nano editor with CTRL + X. Next, let's quickly open the compose.yaml file with nano, and make a small modification there as well.

NOTE: This change is only necessary if you won't be using the Traefik reverse proxy. If you do use Traefik, then DO NOT make this change.

`nano compose.yaml` In this file, we want to remove the section for the Traefik reverse proxy. If you are using Traefik as your reverse proxy, then feel free to leave it in. ```yaml volumes: mongodb_data: { driver: local } services: rocketchat: image: registry.rocket.chat/rocketchat/rocket.chat:${RELEASE:-latest} restart: always labels: traefik.enable: "true" traefik.http.routers.rocketchat.rule: Host(`${DOMAIN:-}`) traefik.http.routers.rocketchat.tls: "true" traefik.http.routers.rocketchat.entrypoints: https traefik.http.routers.rocketchat.tls.certresolver: le environment: MONGO_URL: "${MONGO_URL:-\ mongodb://${MONGODB_ADVERTISED_HOSTNAME:-mongodb}:${MONGODB_INITIAL_PRIMARY_PORT_NUMBER:-27017}/\ ${MONGODB_DATABASE:-rocketchat}?replicaSet=${MONGODB_REPLICA_SET_NAME:-rs0}}" MONGO_OPLOG_URL: "${MONGO_OPLOG_URL:\ -mongodb://${MONGODB_ADVERTISED_HOSTNAME:-mongodb}:${MONGODB_INITIAL_PRIMARY_PORT_NUMBER:-27017}/\ local?replicaSet=${MONGODB_REPLICA_SET_NAME:-rs0}}" ROOT_URL: ${ROOT_URL:-http://localhost:${HOST_PORT:-3000}} PORT: ${PORT:-3000} DEPLOY_METHOD: docker DEPLOY_PLATFORM: ${DEPLOY_PLATFORM:-} REG_TOKEN: ${REG_TOKEN:-} depends_on: - mongodb expose: - ${PORT:-3000} ports: - "${BIND_IP:-0.0.0.0}:${HOST_PORT:-3000}:${PORT:-3000}" mongodb: image: docker.io/bitnami/mongodb:${MONGODB_VERSION:-5.0} restart: always volumes: - mongodb_data:/bitnami/mongodb environment: MONGODB_REPLICA_SET_MODE: primary MONGODB_REPLICA_SET_NAME: ${MONGODB_REPLICA_SET_NAME:-rs0} MONGODB_PORT_NUMBER: ${MONGODB_PORT_NUMBER:-27017} MONGODB_INITIAL_PRIMARY_HOST: ${MONGODB_INITIAL_PRIMARY_HOST:-mongodb} MONGODB_INITIAL_PRIMARY_PORT_NUMBER: ${MONGODB_INITIAL_PRIMARY_PORT_NUMBER:-27017} MONGODB_ADVERTISED_HOSTNAME: ${MONGODB_ADVERTISED_HOSTNAME:-mongodb} MONGODB_ENABLE_JOURNAL: ${MONGODB_ENABLE_JOURNAL:-true} ALLOW_EMPTY_PASSWORD: ${ALLOW_EMPTY_PASSWORD:-yes} ``` From the above we want to remove these lines: ``` labels: traefik.enable: "true" traefik.http.routers.rocketchat.rule: Host(`${DOMAIN:-}`) traefik.http.routers.rocketchat.tls: "true" traefik.http.routers.rocketchat.entrypoints: https traefik.http.routers.rocketchat.tls.certresolver: le ``` In nano, you can put your cursor on the line with "lables:", and then use the CTRL + K hotkey to remove the entire line. Just keeping pressing CTRL + K repeatedly until all of these lines are gone. next, le'ts change the volume mapping line for our MongoDB database to be kept inside of our rocketchat folder. To do that change the line that says: ``` - mongodb_data:/bitnami/mongodb ``` to instead say ``` - ./mongodb_data:/bitnami/mongodb ``` This will keep our compose.yml, .env, and mongodb data all in this folder which makes it much easier to zip up and backup as needed. Now save your changes with CTRL + O, then press Enter to confirm, and exit the nano editor with CTRL + X. Finally, we are ready to pull down the images for our RocketChat instance. `docker compose pull` As the images are pulled, be patient. It can take a bit of time as the images can be large sometimes, and then also have to be extracted (uncompressed). Once the images are pulled down, we'll want to do one more thing. This is just based on my experience, but let's make that "mongodb\_data" folder now, and give it the appropriate permissions it needs: `mkdir mongodb_data` `chmod 777 ./mongodb_data` Let's start our system running with the command: `docker compose up -d && docker compose logs -f` This is really two commands concatenated with the &&. First we tell docker to start the containers, and then we tell it we want to see the logs as it starts. We can stop seeing the logs using the CTRL + C hotkey combination. Once it's up and running, you'll see a lot of text output. You are just looking for errors. If you don't see any errors, you can stop following the logs. Give the system a few minutes to be fully up and running. Now, we just need to setup our reverse proxy. We can open up NGinX Proxy Manager, and add a new Proxy Host. In this case I'm using the IP through my Netbird VPN, but you can use the local network IP, or the Public IP if you prefer. You just need to ensure that "chat.yourdomain.org" is pointing to your NGinx Proxy Manager instance. NGinX will handle the routing from there. In our new proxy host, we'll name our entry with the domain name we want people to use to reach our site. In my case I entered "chat.sysmainit.com". You should use your domain. Next we'll enter the IP we want NGinx proxy manager to use to reach the server where Rocketchat is running. After that enter the port that you set for the HOST\_PORT variable. In my case I set 3000, so that's what I'll enter. Now enable the two options for "Block Common Exploits" and "Websocket Support". Next, select the SSL tab, and in the dropdown that says 'None', select 'Request a New Certificate'. Next, enable the options for 'Force SSL', 'HTTP/2 Support', 'HSTS for both of those entries, then make sure you email is filled in,and accept the LetsEncrypt terms of service. Now click the 'Save' button. You should see the new proxy addition pop-up just close on its own after about 30 seconds. If you don't get any error in the pop up, your proxy is ready. You can now click on the entry in NGinX Proxy Manager, or simply go to the site in your favorite modern browser. You'll be presented with a create account screen to create your first user. This user will be a system admin with all privileges needed to manage your server. Check Out the video for an overview and walk through of the UI. There's a ton here, and you want to make sure to go through and get it setup right. ### Support My Channel and Content **Support my Channel and ongoing efforts through Patreon:** [https://www.patreon.com/awesomeopensource](https://www.patreon.com/awesomeopensource) **Buy me a Beer / Coffee:** https://paypal.me/BrianMcGonagill