Back to Documentation

    Upgrade Guide

    How to upgrade your NetLock RMM Web Console, Server, and Agents to the latest version.

    Web Console & Server

    For Docker

    All you need to do is pull the new image with the following command:

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

    The database structure & agents update automatically. No manual migration steps required.

    Automatically Checking for Updates

    We suggest automatically checking for newer images using Watchtower

    Example to check for a new version every 15 minutes:

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

    Upgrading the Agent

    Configure automatic agent updates through the web console.

    1

    Enable Platform Updates in System Settings

    In the web console, navigate to Settings → System → Updates. Enable the platforms you want to allow updates for and ensure your concurrent agent update/installation limit is high enough.

    NetLock RMM Updates Settings showing platform toggles and concurrent limit
    2

    Enable Auto-Update in Policy Settings

    Make sure the policy assigned to your devices allows automatic agent updates as well.

    NetLock RMM Policy Settings showing auto update agent checkbox

    Troubleshooting

    Agent upgrade failed? If an agent upgrade fails for whatever reason, it usually takes up to 15 minutes until it will be back automatically due to self-healing functionality.

    Common Issues & Solutions

    • •Agent not updating: Verify both the global switch (System Settings) AND the policy setting are enabled.
    • •Slow rollout: Increase the concurrent installations limit based on your available bandwidth.
    • •Update stuck: Check Docker logs with docker logs CONTAINERID