NetLock RMMNetLock RMM Docs
III — How-To Guides

Upgrade NetLock RMM

Upgrade the Web Console, Server, and agents to the latest version, with optional automatic image checks.

Upgrade NetLock RMM

This guide upgrades a NetLock RMM deployment to the latest release: first the server and Web Console, then the agents. The server side applies only to self-hosted deployments. On cloud, the hosted operations team upgrades the platform for you, and you only need the agent steps.

Before you start

  • For the server upgrade (self-hosted): shell access to the host running the NetLock RMM containers, and the path to the docker-compose.yml that defines your deployment.
  • For the agent upgrade: a Console account that can reach Settings → Updates and edit the policy your devices use; see A.2 and Chapter 6.
  • No database migration is required; see the note below.

Upgrade the Web Console and Server

Self-hosted only: This section does not apply to cloud deployments.

The server and Web Console ship as container images. Upgrading means pulling the latest images and recreating the containers. NetLock RMM deployments use a fixed compose-file path, so from the host this single command is all you need:

sudo docker compose -f /home/netlock/docker-compose.yml pull && sudo docker compose -f /home/netlock/docker-compose.yml up -d --remove-orphans

Note: The database structure updates automatically when the new server image starts. There are no manual migration steps. The agent installer packages the server distributes are refreshed at the same time.

From version 3.3.0.11 the server and Web Console images run as the unprivileged user 1654 where the compose file allows it. With the compose file from the guided installer nothing changes: the containers keep running as root and the log shows how to switch. With the compose file from the manual installation guide the containers take ownership of their data directories and switch to user 1654 on their own. With user: "1654:1654" set on both services they start as that user directly.

With the compose file from the manual installation guide, a custom TLS certificate file in /home/netlock/certificates must be readable for user 1654 (chmod 640 and chgrp 1654), otherwise the container keeps running as root and names the file in its log. Once user: "1654:1654" is in the compose file, do not go back to an image older than 3.3.0.11. The details, the log lines and the two steps to switch an existing installation are in Running the containers as an unprivileged user.

Check for new images automatically

To avoid pulling manually, you can run a container-update watcher such as Watchtower alongside the stack. The command below starts Watchtower with a 15-minute check interval:

sudo docker run --detach \
    --name watchtower \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    --restart unless-stopped \
    nickfedor/watchtower \
    --interval 900

Watchtower is a third-party tool and is not part of NetLock RMM; adopt it at your own discretion.

Upgrade the agents

Agents update themselves. Once the server offers a new agent version, every agent whose policy has Auto-update agent on installs it on its next sync.

  • The policy option. In the Policy Settings editor, on the Agent tab, Auto-update agent is on by default. Leave it on; turn it off only for a golden image. See Chapter 6.
  • The concurrency limit. Max concurrent installations & updates in Settings → Updates caps how many agents update at the same time. See A.2 for what the value controls and how to size it.

Verify it worked

  • The Web Console reports the new version once the server containers have restarted.
  • A device shows the new agent version on its detail page after it has synced and applied the update.

Troubleshooting

  • Agent not updating. Check that Auto-update agent is on in the device's policy. If it is off, the agent stays on its current version.
  • Slow rollout. Raise Max concurrent installations & updates in Settings → Updates, within what your network bandwidth supports; see A.2.
  • An agent upgrade failed. The Health agent repairs a failed agent update on its own, usually within about 15 minutes. If the device stays offline, see Debug an agent.
  • An update appears stuck on the server. Inspect the container logs with docker logs <container-id> to see what the service reported.