Rocket Chat - Change ROOT_URL and Site URL How to change the Rocket Chat's Site URL after changing the ROOT_URL in the rocketchat.service file

Rocket Chat - Change ROOT_URL and Site URL

Today I was playing with Rocket.Chat, a neat open source web chat platform / framework with a lot of useful features. Unfortunately, the project still has a lot of issues during the installation and first configuration phases; for this very reason, within the first few hours I had to deal with several issues that were not documented in the official site and/or within the GitHub's issues tab.

More specifically:

  • The Heroku one-click installer is broken (at the time of writing).
  • The ROOT_URL configuration settings works in a misleading way and can easily prevent you from being able to run the app.

Unfortunately, at the time of writing there are no working fixes for the first issue (see issues #16179 and #16333, both still open and unresolved as of today); the only way to get over it is to perform a Manual Installation by strictly following the instructions given by the official website, which are basically OK - at least for CentOS 7 and 8.

The issue

As for the latter issue, here's a breakdown summary for the problem: during the manual installation phase, you'll have to specify the remotely accessible URL for your own Rocket.Chart service, which will be in the following form:


More precisely, you'll have to write it down in an Environment Variable called ROOT_URL, which is contained within the /lib/systemd/system/rocketchat.service file. If you type it properly (and don't want to change it afterwards) you'll be good to go: however, if you want (or need) to change it later on, you'll easily notice that all the subsequent changes you might want to apply to that environment variable won't work: as a matter of fact, the web service will still continue to listen to the old file.

Such odd behaviour can be easily confirmed by launching a systemctl status rocketchat and see the Site URL parameter that will be shown in the console: you'll always see the firstly inserted ROOT_URL value there, regardless of any change you might have made to the ROOT_URL variable afterwards.

It goes without saying that I tried to reload the units...

... and also to restart the web app...

... and even to reset the server by issuing a reboot  command: unfortunately, none of those workaround worked.

The reason

After almost an hour I finally found the underlying reason of the problem: it seemed like, when the service is launched for the first time, it reads the ROOT_URL value and immediately writes it within the MongoDB database; such db-stored value becomes then the only "source" that the web app actually reads on all subsequent starts, thus ignoring the ROOT_URL environment variable since then.

That's definitely a strange behaviour to deal with an environment variable, isn't it?

The fix

Luckily enough, once the underlying cause of the issue has been exposed, the fix was easy enough to pull off:

  • Open a Terminal session (or a SSH shell)
  • Open a mongo shell by typing mongo
  • type use rocketchat to switch to the rocketchat database.
  • type db.rocketchat_settings.update({"_id" : "Site_Url"},{$set:{value:"<YOUR NEW URL>"}})  to change the former Site_Url value stored within the DB with a new one of your choice; needless to say, replace the <YOUR NEW URL> placeholder accordingly to suit your needs.


That's it, at least for now: I definitely hope that this post will help some system / network administrators who are trying to figure out why their Rocket.Chat instance's Site URL is not changing at all despite all the changes performed on the ROOT_URL environment variable.


About Ryan

IT Project Manager, Web Interface Architect and Lead Developer for many high-traffic web sites & services hosted in Italy and Europe. Since 2010 it's also a lead designer for many App and games for Android, iOS and Windows Phone mobile devices for a number of italian companies. Microsoft MVP for Development Technologies since 2018.

View all posts by Ryan

5 Comments on “Rocket Chat - Change ROOT_URL and Site URL How to change the Rocket Chat's Site URL after changing the ROOT_URL in the rocketchat.service file

  1. Thank you for this guide. I just set up a Rocket.Chat instance using DigitalOcean’s automated process and encountered precisely this issue. Your suggestion solved it for me.

  2. For those installing RC via Snap – the mongo shell is accesible under the command: rocketchat-server.mongo


    I did wasted about a one and a half days trying to deal with this Rocket.Chat issue.

    The main symptom was an error in Chrome saying “ERR_CERT_AUTHORITY_INVALID”

    And the solution you’ve proposed worked like a charm!

    Thank you again! You’re the Man! :)

Leave a Reply

Your email address will not be published. Required fields are marked *

The reCAPTCHA verification period has expired. Please reload the page.

This site uses Akismet to reduce spam. Learn how your comment data is processed.