Overview

This article describes how to install a fresh copy of UNMS on your server, or update an existing installation. This is a guide for a Linux installation, see the following note for Windows and OS X users:

NOTES & REQUIREMENTS:

Unfortunately, for Windows and OS X systems, we can't ensure proper operation, smooth backups, and upgrades of critical Docker containers. At this time we recommend that you install VirtualBox with the latest version of Ubuntu 16.04.1 LTS (Xenial Xerus) 64 bit and then follow the Linux instructions provided below.

Table of Contents

1. Prerequisites
2. Installation Instructions
3. Related Articles

Prerequisites

Back to Top

• Supported Distros (LXC virtualized Distros aren’t officially supported please use KVM):
  
  • Ubuntu 16.04.1 LTS (Xenial Xerus) 64-bit
  • Ubuntu 18.04 LTS (Bionic Beaver) 64-bit
  • Debian 9 64-bit
  • CentOS 7 thanks to andrewglass3
  • Container Linux formerly CoreOS thanks to woopstar
• 2 GB RAM (Minimal)
• 16 GB storage (Minimal)
• 64-bit (x64) CPU
• Local Ports: 80 and 443 (see Changing the HTTP and HTTPS ports)
• Allow ping (see Devices Latency and Outage Statistics)
• Kernel with overlay2 storage driver (see Docker Storage Drivers)
• bash, curl, sudo, netcat (see Installing prerequisites)

Installation Instructions

Back to Top

Run the command below on the host to install and start UNMS (it will automatically install Docker if it is not installed already). If a UNMS installation already exists, it will be overwritten, but all data will be kept. You can use the attribute--updateif you want to be sure the new installation will have the same parameters as the old one.  You can register your devices to UNMS by following this article: The UNMS Key and the Device Registration Process. In case you need to customize the installation process please read Optional installation steps.

curl -fsSL https://unms.com/install > /tmp/unms_inst.sh && sudo bash /tmp/unms_inst.sh

The installation script will check if your ports :80 and :443 are open and if they are not, it will ask you to specify which ports you want UNMS to use. The same applies to the overcommit memory settings. If the vm.overcommit_memory is not set to '1', the installation script asks for a permission to do it. In case you do not want to be bothered with those interrupts in the installation process you can use --unattended attribute to let the installation script do all the necessary arrangements by itself. 

When the process is complete, you can access UNMS at http://server_hostname_or_ip/. Please don't use localhost. Use server hostname or its IP address. 

Related Articles

Back to Top

UNMS - Optional Installation Steps
UNMS - The UNMS Key and the Device Registration Process