Aurora Files documentation

Chat

In v9.1 of Aurora Files we have added chat feature. This is implemented by providing integration with RocketChat, free opensource chat solution. To use chat in Aurora Files you need to install RocketChat and configure its integration module from Aurora admin interface.

Installing RocketChat

To install RocketChat, follow the official installation instructions. Make sure your system meets minimal system requirements.

While it's possible to install RocketChat and Aurora Files on the same server, we recommend running RocketChat on a separate system. We have used DigitalOcean droplets for this purpose, with Debian installed there; RocketChat documentation contains installation guide for Debian.

NB: We've discovered that it's no longer possible to install NodeJS on Debian 9 using those instructions.
It works on Debian 10, be sure to install Node v12.22.1.
To install MongoDB there, you'll need to follow official MongoDB guidelines.

RocketChat does not offer SSL/HTTPS support, but it's possible to provide HTTPS by setting up a reverse proxy, and we strongly recommend doing so. One of the options is installing nginx webserver and setting up reverse proxy there. You can use your existing SSL certificate, create a self-signed one, or generate one using Let's Encrypt. If you choose to go with Let's Encrypt certbot, your certificate settings in nginx configuration will be something like:

    ssl_certificate /etc/letsencrypt/live/chat.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/chat.yourdomain.com/privkey.pem;

If you wish to force redirect from HTTP to HTTPS, that's done by adding the following section to nginx config:

server {
    listen 80;
    server_name _;
    return 301 https://$host$request_uri;
}

Note that you can follow the instructions on configuring Let's Encrypt reverse proxy. Redirecting from HTTP to HTTPS can be enforced there automatically if you wish.

How chat integration works

Once you have chat integration enabled (see the next section), chat accounts will automatically be created for users of your Aurora Files installation. Chat accounts will use the same email and password as credentials, and the username will be generated based on email address - using its username part, and the first word of the domain part, separated with a dot.

For example, chat user for myname@thedomain.co.uk will be created with myname.thedomain username.

NB: Bear in mind that changing user's email address, username or password through RocketChat admin or user interface may result in being unable to log into chat from Aurora. That's why in our integration we're blocking features like changing account data or password reset.

Setting up integration with RocketChat

When you have RocketChat installation up and running, available over HTTPS and with admin user assigned, you can proceed with configuring chat integration of Aurora Files. First of all, make sure Disabled is set to false in data/settings/modules/RocketChatWebclient.config.json configuration file.

The rest of the configuration options are set from within adminpanel. You need to supply RocketChat installation URL, admin username and password:

Chat settings 1

Please note that admin password is stored in the configuration file in encrypted fashion. Thus, editing it directly in config will not work, you need to supply password using this screen of admin interface.

Save setting and proceed to the next area. Some of RocketChat configuration options need to be adjusted, for integration to work correctly:

Chat settings 2

The last area of chat integration settings is optional, but we strongly recommend applying those settings as well. In there, we set default text on home page and site name, and we also change the visual styles to resemble default colors of Aurora Files design:

Chat settings 3

Styles and site name are copied from Aurora Files installation, so if you reconfigure the product in the future, make sure to apply these changes here again.

Using chat

Once you have chat integration enabled, users will be able to access Chat from within Aurora Files interface:

Chat 2

If user currently has another tab open in Aurora Files interface, Chat tab will show a number of unread messages:

Chat 1

Users can also message each other from within Team section of Contacts screen, clicking Chat button there will open a popup window - and recipient's chat account will automatically be created, if it doesn't exist yet:

Chat 3

Under Settings screen, users will find their access details for logging into RocketChat installation; these data will only be needed for those willing to use RocketChat desktop or mobile application:

Chat 4