Skip to main content

Licensing Overview

MAPS uses a license-based model to enable features and manage limits.

License Retrieval​

When the server starts it attempts to obtain a license automatically.

  1. The server contacts the MapsMessaging license service.
  2. If a Client ID / secret is configured in license.yaml, the server requests and downloads the license associated with that client.
  3. If no Client ID / secret is configured, a Community license is issued automatically.
  4. If the server cannot reach the license service (for example, no internet access), a license file can be installed manually.

Manual licenses should be placed in:

[MAPS_DATA]/licenses

The server will detect the license file during startup and install it automatically.

Offline Operation​

Official MAPS release packages include a fallback Community license to allow the server to start in restricted or offline environments.

If the license service cannot be reached during startup, the server will use the locally available license from:

[MAPS_DATA]/licenses

Administrators can replace or update licenses in this directory at any time.

License Flow Diagram​