System overview & licensing

Self-hosted only: This chapter is written for self-hosted deployments. On cloud, both pages still open but render a reduced view — a banner reads "Some settings that are available in the On-Premises version are not visible here. This is because our cloud team manages these.", and the deployment-level sections (MySQL health, File Server and Remote Server status, the Members Portal API key, and the editable storage limit) are hidden because the hosted operations team manages them. Cloud users still see the Web Console resource panel and storage-usage card on Overview and the licence status on Licensing; the rest of this chapter does not apply to them.

This chapter covers two administrative pages that share a common purpose — giving the deployment operator a view of how the system is performing and what the current licence allows. Both are predominantly observational: the Licensing page is entirely read-only, and the System Overview page is read-only apart from one setting, the System Storage Limit. Licence keys and connection strings are never editable in the Console; they are mutated outside it, in appsettings.json.

A.1.1 System Overview

Settings → Overview at /settings/overview is the first port of call when you want to answer "is everything healthy?" at a glance. It is almost entirely a monitoring page — it shows the live state of the four subsystems a self-hosted NetLock RMM deployment depends on, using the same data the agents and backend services use to do their work. The one exception is the System Storage Limit panel, which carries a single editable setting; everything else on the page is read-only.

The MySQL section

The database section answers two questions: is the database reachable, and is it under load. A status icon at the top of the section turns green when the Console has an active connection to MySQL and red when it does not. The panel reports:

• Version — the MySQL server version string.
• Uptime — elapsed seconds since the MySQL instance started.
• Active connections — the number of sessions currently open against the server.
• Database size — total size of the NetLock RMM database, in bytes.
• Max connections — the configured upper limit for concurrent sessions.
• Failed logins — a running count of authentication failures since the database started.

Below those counters, a searchable table lists every active query the database is currently executing. Columns are Id, User, Host, Database, Command, Time, State, and Info. This is the view to open first when the Console feels slow — a long-running query or a connection pile-up often shows up here before it shows up anywhere else.

The Web Console section

Three cards summarise how much resource the machine hosting the Web Console is using right now:

• CPU usage — a percentage with a progress bar.
• RAM usage — a percentage with a progress bar, plus a Used / Free / Total breakdown in GB.
• Disk usage — a percentage with a progress bar, plus a Used / Free / Total breakdown in GB.

The values are sampled from the Web Console host, not from any individual managed device. Use the section as an early warning when the Console itself is about to run out of headroom — a sustained high CPU number on this panel is a cue to scale the host, not the fleet.

System Storage Limit

The System Storage Limit panel is the one place on the Overview page that accepts input. It caps how much data the NetLock RMM system is allowed to store on disk — the on-screen description states this covers the devices/ and internal/ folders together with the MySQL database size.

A usage card shows current consumption as <current> GB / <limit> GB with a progress bar that shifts from green to amber at 90% and to red at 100%, plus a line reporting how many GB remain.

A second card carries the editable control: a Storage limit (GB) numeric field (1 to 999999) and a Save button. Set the value and save it to change the cap.

When consumption crosses a threshold the Console raises a dialog automatically — a warning at 90%, and a limit-reached dialog at 100% that cannot be dismissed by clicking away until you free space or raise the limit.

File Server and Remote Server status

Two smaller panels report the Console's ability to reach the other two backend services in a NetLock RMM deployment.

• NetLock RMM File Server — shows Connected when the Console can talk to the File Server, Not connected otherwise. The File Server is responsible for agent downloads, script artefacts, and attachment storage.
• NetLock RMM Remote Server — shows Connected when the Console can talk to the Remote Server, which handles remote control sessions and relay. A failed check here is accompanied by a PTR-mismatch warning when the probable cause is a reverse-DNS misconfiguration; the warning includes a link to the relevant documentation.

If either panel shows Not connected, use the Check again action at the top of the page to re-run the connectivity probe without reloading the entire page. The button is especially useful during an incident — rather than refreshing the entire Overview and losing any searches you have already typed into the MySQL active-queries table, Check again only retests the two service endpoints and updates their status chips.

A persistent Not connected state on either service is a signal to check the service's own host. For the File Server, confirm the service is running and that the Console host can reach it on its configured port; for the Remote Server, confirm the service is running and that the public DNS record resolves correctly — in particular, that the PTR record matches, because the warning message on the page exists precisely because PTR mismatches are the single most common cause of a failed Remote Server check.

What the page cannot do

Apart from the System Storage Limit, the Overview page is observational. Its only interactive controls are the Save button for the storage limit and the Check again button for the service connectivity probes. To change any of the monitored values — MySQL connection string, File Server URL, Remote Server URL — you edit appsettings.json on the Console host and restart the Console. There is no in-Console editor for connection strings by design: those values are part of deployment, not runtime configuration.

A.1.2 Licensing

Settings → Licensing at /settings/licensing reports the status of your NetLock RMM licence against the Members Portal. Like Overview, this page is mostly read-only — the one actionable control is a refresh button.

Members Portal API key

At the top of the page, an Enter your API key here text field shows the API key the Console uses to query the Members Portal. The field is read-only in the UI; its content is loaded from appsettings.json at startup. A helper note beneath the field states:

The API key can only be changed in the appsettings.json.

This is deliberate — the licence key is a deployment credential. Keeping it out of the Console prevents an admin from accidentally overwriting it on production and prevents a user with settings_enabled from seeing or changing the key without filesystem access to the host.

License status

The second section summarises the licence itself:

• A status badge — Active (green) when the licence is in good standing, Expired (red) when it has lapsed.
• The licence name, which reflects the tier you are subscribed to.
• A code-signing row. When code signing is included in your tier, the line reads Code signing enabled. When it is not, the line reads Code Signing not available with the sub-text Available from Tier 1 for professional deployments. Code signing affects how agent installers are trusted on the managed devices; the absence of it is not a blocker for most deployments, but it is a meaningful signal for larger customers.
• A licence-count row shown as X / Y with a progress bar, where X is the number of seats you are currently consuming and Y is the total you are licensed for. Seat consumption is driven by approved devices — unauthorised devices (see Chapter 3.2) do not count until they are approved.

Actions

Two buttons sit alongside the status section.

• Refresh License Information — re-fetches the licence record from the Members Portal. The button is disabled when no API key is configured. Use this after renewing a licence, adding seats, or upgrading a tier — the Console caches the licence state and does not automatically re-query.
• Upgrade — shown only when code signing is not available for your current tier. The button opens https://www.netlockrmm.com/pricing in a new tab so you can compare plans. There is no in-product checkout flow; upgrades are handled on the pricing page and through your account manager.

What the page does not do

There is no licence-key entry field, no "replace licence" affordance, and no in-product billing view. The page reads; it does not write. If you need to change the API key you edit appsettings.json. If you need to change the plan you do so on the pricing page or through the Members Portal, then come back to the Licensing page and click Refresh License Information to pull the updated status.

Cross-reference

Licensing settings are not accessible on cloud deployments — the cloud team handles billing and licensing centrally. If you log in to a cloud tenant and cannot see this page, that is by design.

Permissions

Both flags must be set on a user's permission matrix (see Chapter 14) for the corresponding page to appear in the navigation.

Related chapters

• Chapter A.3 — Database management. The Overview page reports MySQL health; A.3 is where you configure retention and run optimisation.
• Chapter A.2 — Updates & maintenance. The concurrency cap that governs agent installers lives there.
• Chapter 14 — Users & Roles. Where you grant settings_enabled and the per-page flags.
• Chapter 9 — File Server & Monitoring. Covers the File Server and Relay Server services the Overview page probes.