UNMS - How to Customize Docker Subnet


This guide will show how to manually install docker containers necessary to run UNMS.

warning_25x25white.png WARNING:

This guide is very preliminary and has had minimal testing. Use at your own risk.



This guide was tested with UNMS 0.8.0. The procedure will likely not work with other releases.



Docker Engine 1.10.0 or later

- Docker Compose 1.9.0 or later


Table of Contents

  1. Introduction
  2. Steps: Installation
  3. Related Articles


Back to Top

This guide is intended only for those who need to install UNMS on a system that runs Docker, but CANNOT run the official installation scripts. Most users should follow the instructions found in UNMS - Installation Guide.

This installation guide references tools like useradd, usermod, curl and envsubst. You may need to substitute alternative tools available on your system.

All commands must be executed as root.


Steps: Installation

Back to Top

1. Create or choose a user account for UNMS and add it to group docker


useradd -m "${UNMS_USER}" usermod -aG docker "${UNMS_USER}"

warning_25x25white.png WARNING:

The UID of the UNMS user account must be >=1000. Docker has trouble mapping UIDs lower than 1000 to the user accounts inside containers.

2. Download and unpack the UNMS installation package to /home/${UNMS_USER}/app

mkdir /home/${UNMS_USER}/app
cd /home/${UNMS_USER}/app
curl -sS "https://raw.githubusercontent.com/Ubiquiti-App/UNMS/master/unms-${UNMS_VERSION}.tar.gz" | tar xz

3. Substitute all variables in docker-compose.yml.template to create docker-compose.yml

export VERSION=${UNMS_VERSION}# UNMS version to instal
export USER_ID=$(id -u ${UNMS_USER})# UID of the UNMS user account
export HTTP_PORT=80# HTTP port for UNMS
export HTTPS_PORT=443# HTTPS port for UNMS
export PUBLIC_HTTPS_PORT=443# Port where UNMS UI is exposed to users
export PUBLIC_WS_PORT=443# Port where UNMS is exposed to devices
export BEHIND_REVERSE_PROXY=false# true if running behind a reverse proxy
export SSL_CERT= # SSL cert filename (optional)
export SSL_CERT_KEY= # SSL cert key filename (optional)
export SSL_CERT_CA=# SSL cert CA filename (optional)
export INTERNAL_WS_PORT=8443
export DOCKER_IMAGE=ubnt/unms
export BRANCH=master export CONFIG_DIR=/home/${UNMS_USER}/app/conf
export DATA_DIR=/home/${UNMS_USER}/data export CERT_DIR_MAPPING=
export PROD=true
export DEMO=false
export HOST_TAG=

cd /home/${UNMS_USER}/app
envsubst docker-compose.yml.template docker-compose.yml

4. Create data volumes under /home/${UNMS_USER}/data


mkdir "${DATA_DIR}"
mkdir "${DATA_DIR}/cert"
mkdir "${DATA_DIR}/redis"

5. Set file ownership and permissions

chmod -R 700 "${DATA_DIR}"
chown -R "${UNMS_USER}" "/home/${UNMS_USER}"

6. Run Docker Compose

cd /home/${UNMS_USER}/app;
/usr/local/bin/docker-compose -p unms up -d

7. Verify that UNMS is up and running

docker ps

Status of all UNMS containers should be Up. In case any of the containers are Restarting or not running, or the UNMS URL is not accessible, consult the log files located under /home/${UNMS_USER}/data/logs

Related Articles

Back to Top

UNMS - Installation Guide