Skip to content

Quick Start

Deploy LiMon in under 10 minutes.

Prerequisites

Hardware: 2 GB RAM, 10 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/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 4000). 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.

curl -fsSL https://limonops.com/docker-install.sh | bash

The installer pulls the image, generates secure credentials in .env, and starts the LiMon stack.

For air-gapped environments, download the .tgz archive first and run:

LIMON_TARBALL=/path/to/limon-docker.tar bash docker-install.sh

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-2026.1.2.deb
sudo limon-setup

For RHEL/Rocky/Alma: 

sudo dnf install ./limon-2026.1.2.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 the required OS and Python dependencies first, then install the LiMon package and run sudo limon-setup.

2. Open the dashboard

Navigate to https://your-server in your browser (the installer generates a self-signed TLS certificate).

3. Add your first license server

Edit /opt/limon/config/config.yml and add your license servers:

servers:
  flexlm:
    - server: "27000@license-server.local"
      description: "Engineering CAD Licenses"
  rlm:
    - server: "5053@rlm-server.local"
      description: "Development Tools"

Restart the services:

sudo systemctl restart limon-monitor limon-api

Use the Admin UI Setup Wizard:

  1. Click Add Server in the Admin panel
  2. Select the license manager type (FlexLM, RLM, LM-X, or DSLS)
  3. Enter the server address in port@hostname format (e.g. 27000@license-server.local)
  4. Click Test Connection to verify network access
  5. Click Save

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

Next steps