This article describes additional features of UCRM installation process. It includes changing ports for accessing through GUI, managing the HTTPS access and setting up of additional installation parameters.
NOTES & REQUIREMENTS:
Before you begin, run the following commands on your Ubuntu or Debian system to ensure that all required tools are installed:
Table of Contents
Custom Installation Parameters
By default, UCRM is configured with ports 80, 443 for web application and 81 for suspended clients' redirection and with few other default parameters. If you want to configure your custom installation, you can append some or all of these parameters:
- --http-port, for example: 8080
- --https-port, for example: 8443
- --suspension-port, for example: 8081
- --netflow-port, for example: 2055
- --subnet, for example: 192.168.80.1/24
- --subnet-internal, for example: 192.168.90.1/24
- --ucrm-user, for example: ucrm
Example of UCRM installation with ports 8080 / 8443 / 8081:
curl -fsSL https://ucrm.ubnt.com/install > /tmp/ucrm_install.sh
sudo bash /tmp/ucrm_install.sh --http-port 8080 --https-port 8443 --suspension-port 8081
Changing the HTTP and HTTPS Ports
Use installation script arguments --http-port <NUMBER> and --https-port <NUMBER> to configure the UCRM server to listen on non-standard ports. Defaults are 80 (HTTP) and 443 (HTTPS).
curl -fsSL https://ucrm.ubnt.com/install > /tmp/ucrm_install.sh && sudo bash /tmp/ucrm_install.sh --http-port 8080 --https-port 8443
Note that you can modify the used ports any time later when UCRM is already installed and running. See this guide for managing UCRM ports.
ATTENTION: Please be aware that UCRM must be accessible from the internet via HTTP port 80 if you want to use automatic SSL certificate management via Let's Encrypt.
By default, the installation script ensures that the application data (database, pictures, invoices, encryption key, etc.) will be stored outside the docker container (/home/ucrm/data). This will enable you to backup that data and more importantly, this will enable you to perform any future UCRM upgrades without any data loss.