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.ymlthat defines your deployment. - For the agent upgrade: a Console account that can reach
Settings → Updatesand 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-orphansNote: 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 900Watchtower 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 Settingseditor, on theAgenttab,Auto-update agentis on by default. Leave it on; turn it off only for a golden image. See Chapter 6. - The concurrency limit.
Max concurrent installations & updatesinSettings → Updatescaps 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 agentis on in the device's policy. If it is off, the agent stays on its current version. - Slow rollout. Raise
Max concurrent installations & updatesinSettings → 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.
Related
- A.2 — Updates & maintenance — the
Settings → Updatespage and the concurrency cap in detail. - Chapter 6 — Policies — the
Auto-update agentpolicy setting. - Deploy your first agent — installing an agent for the first time.