In order for the installation to work flawlessly and the system to run as smoothly as possible, please add the following exceptions to Windows Defender:
Docker behind a corporate proxy
To configure the Docker client behind a proxy, you have to configure the Docker service to use your proxy.
Often the customer certificate is provided as PFX/P12 but NGINX doesn't support it. We have to convert the format PFX/P12 to a format more generic which is called PEM. The command line tool OpenSSL provide an easy way to explode the certificate in 2 parts, the certificate(only) and the key of the certificate which is used to make the cryptographic operations.
This is NOT MANDATORY to install the OpenSSL command line on the server, you can install it anywhere, execute the commands and move the certificate files(*.crt, *.key) to the server.
To extract the certificate and its parents, execute the following command in your terminal, this file will contain information of your server and organization.
Once the files(*.crt, .key) moved to the server, in the ROOMZ certificate folder(e.g. C:\ROOMZ\Certificates), replace each files by your files(*.crt, *.key).
Which files should be replaced to use my SSL certificate
All ROOMZ certificates are in the folder ROOMZ\Certificates, which is often C:\ROOMZ\Certificates.
By default, you should replace the files login-cert.crt, login-cert.key, portal-cert.crt, portal-cert.key, portal-api-cert.crt, portal-api-cert.key, viewer-cert.crt, viewer-cert.key and set your certificate password in the files login-cert.pass, portal-cert.pass, portal-api-cert.pass, viewer-cert.pass by your certificate files(*.crt, *.key) extracted using OpenSSL.
Windows SQL Authentication
ROOMZ On-Premise uses a SQL Database, which will be installed during the setup.
The SQL Database will grow from approximately 20MB every year by workspace.
We suggest a database size of 5GB on premise.
ROOMZ needs an access to your SMTP server to send invitation for the new users created in the portal. To test the SMTP configuration before adding it into the .env file on your server, you can test the settings using the following command.
Download the ROOMZ archive containing the images from a computer with an internet access, copy the archive on your server, unzip the archive on your server and import the images by executing the following commands where the images are.
The ROOMZ Archive is not available to download on the portal and can only be provided by ROOMZ
An instance of SQL Express is included in the container. The next steps assume that you are using this default instance and not your own SQL server
It's recommended to use Powershell as terminal for the following instructions.
On your offline server, please follow the instructions.
Configure your anti-virus software, by following the Docker instructions and exclude the processes dockerd.exe, dotnet.exe, erl.exe and node.exe too.
Copy the archive into the folder C:\ROOMZ.
Unzip the archive and import the images by executing the following commands where the images are.