Skip to content

Quick Start

Deploy LiMon in under 10 minutes.

Prerequisites

Hardware: 2 GB RAM, 20 GB disk (minimum).

Software requirements depend on the deployment model:

Deployment You provide
Docker Docker Engine 20.10+ and Docker Compose v2
Native package A supported Python runtime, Python virtual-environment support (venv), pip, and MariaDB 10+ or MySQL 8.x

Offline wheels for native packages

LiMon native packages ship prebuilt offline wheels for Python 3.9, 3.11, and 3.12. On those Python versions, the installer can satisfy the Python module layer without reaching PyPI. On another Python version, the installer will tell you which modules must be installed with pip first.

Vendor binaries: LiMon calls vendor-supplied command-line utilities to query your license servers. You must provide the linux util binary for each vendor type you want to monitor:

Vendor Binary Default path
FlexLM / FlexNet lmutil /opt/limon/tools/lmutil
RLM rlmutil /opt/limon/tools/rlmutil
LM-X lmxendutil /opt/limon/tools/lmxendutil
DSLS (Dassault) DSLicSrv /opt/limon/tools/linux_a64/code/bin/DSLicSrv

Place the binaries in the tools/ directory before or after installation. You only need the ones for the vendor types you use. If a binary is missing, that server type will report as DOWN but LiMon will continue to work for the other types.

Why binaries are not included?

These binaries are proprietary and cannot be shipped with LiMon. They are:

  • Already included with your license manager package OR
  • Available to download from your vendor's support portal

This ensures the binaries match your license manager version and is safer since you receive them directly from your vendor. Plus it saves all of us from legal complications.

Network access: The LiMon host must be able to reach each license server on its configured port (e.g. FlexLM default 27000, RLM 5053, LM-X 6200, DSLS 4084). As a rule of thumb we need the same access to the license server than your users have.

1. Install LiMon

Choose the deployment model that matches your environment. Docker is the fastest self-contained path. Native packages fit hosts where you want LiMon managed as normal Linux services.

Host requirements: Docker Engine 20.10+ and Docker Compose v2.

Download the Docker bundle from the customer portal, copy it to the Docker host, and extract it:

tar -xzf limon-docker-<version>.tgz
cd limon-docker-<version>

Run the local installer from the extracted directory:

bash docker-install.sh

The installer creates /opt/limon/, loads the bundled Docker images locally, generates secure database credentials, starts the stack with Docker Compose, and prints the URL for the Setup Wizard. It does not clone from GitHub, contact a public registry, or fetch an install script from the internet.

Host requirements: Native packages are available in Linux most common formats. The target host must provide a supported Python runtime (3.9+), Python virtual-environment support (venv), pip, and a local or remote MariaDB 10+ or MySQL 8.x database.

For Debian/Ubuntu:

sudo apt install ./limon-<version>.deb
sudo limon-setup

For RHEL/Rocky/Alma:

sudo dnf install ./limon-<version>.rpm
sudo limon-setup

If the machine can reach your configured OS repositories, apt and dnf will resolve and install any missing package dependencies automatically.

Offline wheels included

LiMon ships prebuilt offline wheels for Python 3.9, 3.11, and 3.12. If your host uses one of those versions, the installer can satisfy the Python module layer offline. If your host uses another Python version, the installer will tell you which modules must be installed with pip first.

Fully offline native installs

If the host is truly offline and cannot reach any package repositories, install any required OS and Python dependencies first, then install the LiMon package and run sudo limon-setup.

2. Open the Setup Wizard

Open the URL printed by the installer. For Docker installs this is usually the proxied host URL. For native packages, use http://<host>:8585/setup/.

3. Add your first license server

Use the Setup Wizard:

  1. Continue to the Servers step
  2. Select the license manager type (FlexLM, RLM, LM-X, or DSLS)
  3. Enter the server address in port@hostname format (e.g. [email protected])
  4. Click Test Connection to verify network access
  5. Finish activation and review

LiMon will begin polling immediately and display results on the dashboard.

Next steps

  • Admin UI — Add more servers, applications, feature mappings, and sites
  • The Frontend — Explore live monitoring views, usage trends, current state, and reports
  • Live View — Check monitor status, recent logs, and polling-cycle metrics