Quick Start
Deploy LiMon in under 15 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 package matching your Linux distribution (uses its system Python), plus venv, pip, and MariaDB 10+ or MySQL 8.x |
Offline wheels for native packages
Each native package bundles prebuilt offline wheels matching its target distribution's Python, so the installer can satisfy the Python module layer without reaching PyPI.
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 UNKNOWN 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:
Run the local installer from the extracted directory:
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: LiMon ships native .deb and .rpm packages built for the most common Linux distributions and versions — just choose the one that matches your host. Each package is built against its distribution's system Python, so you don't install or manage a Python runtime yourself. Beyond that, the host needs Python virtual-environment support (venv), pip, and a local or remote MariaDB 10+ or MySQL 8.x database.
For Debian/Ubuntu:
For RHEL/Rocky/Alma:
If the machine can reach your configured OS repositories, apt and dnf will resolve and install any missing package dependencies automatically.
Offline wheels included
Each package bundles prebuilt offline wheels matching its target distribution's Python, so the installer can satisfy the Python module layer offline.
Missing prerequisites
If the host doesn't already meet the requirements (Python, venv, pip, database), install those first, then install the LiMon package and run sudo limon-setup. On a host with repository access, apt/dnf handle this for you; on a fully offline host, provide the OS and Python dependencies yourself beforehand.
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/.
Complete the company, database, and monitoring settings. When the Security step displays the generated API key, copy it and store it securely: you will need it to sign in to the Admin UI, and the wizard will not display it again.
3. Configure the license tool path
On the License Tools step:
- Find the license manager type you want to monitor
- Enter the full path to its vendor utility, such as
/opt/limon/tools/lmutilfor FlexLM - Test the tool and confirm that LiMon reports a valid, executable Linux binary
Only configure the tools you use. You can leave the other paths empty and add them later from the Admin UI.
4. Add your first license server
On the Servers step:
- Click Add
- Select the license manager type (FlexLM, RLM, LM-X, or DSLS)
- Enter the server address in
port@hostnameformat (e.g.[email protected]) - Click Test Connection to verify network access
The server type must have a valid tool path from the previous step. If the connection test fails, confirm that the LiMon host can reach the hostname and port and that the selected vendor utility is correct.
5. Generate and activate your license
On the Activation step:
- Copy the complete Installation ID shown by the wizard
- Open the LiMon license portal
- Paste the Installation ID into the portal and generate your evaluation or purchased license
- Copy the generated license key from the portal
- Return to the Setup Wizard, paste the key into the license field, and continue
The license is generated for this specific Installation ID, so copy both values in full and do not substitute an ID from another LiMon instance.
6. Review and start monitoring
Review the settings, activate the instance, and wait for LiMon to restart. Sign in to the Admin UI with the API key you saved earlier, then open the dashboard to confirm that the first polling results appear.
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