UCRM - Optional Installation Steps


Overview


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:

sudo apt-get update
sudo apt-get install curl sudo bash


Table of Contents

  1. Custom Installation Parameters
  2. Changing the HTTP and HTTPS Ports
  3. UCRM Data
  4. Related Articles

Custom Installation Parameters


Back to Top

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
  • --version, for example: 2.9.0
  • --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


Back to Top

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.

UCRM Data


Back to Top

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.


Related Articles


Back to Top

UCRM - Installation Guide

UCRM - Backup and Migration