Update your Impreza agent

New servers receive the stable agent. Existing servers keep their installed version until you choose to update. Current stable: 0.6.2.

Check and update #

On the server, check the installed and available versions:

curl -fsSL https://raw.githubusercontent.com/imprezahost/agent-public/main/update.sh | sudo sh -s -- --check

After all deployment operations have finished, apply the update:

curl -fsSL https://raw.githubusercontent.com/imprezahost/agent-public/main/update.sh | sudo sh -s -- --apply

No bootstrap token is required. This command also works on older agents such as 0.5.1. The updater verifies SHA-256 and the embedded version, then replaces the executable atomically. It restarts only the agent, keeping its identity, configuration and app containers. If startup fails, it restores the previous executable.

Portal and MCP #

Under Your servers, open the agent update option and copy the command. The portal and impreza_list_servers expose update information from GET /v1/platform/servers. An unknown installed/latest version produces an unknown availability status, not a claim that the agent is current. Run the command on the correct server; listing servers does not execute an update.

Confirm the new version after the next heartbeat. Local service startup does not prove that the API is reachable. Update only when deployments are idle; the updater does not drain queued commands. It refuses downgrades and does not support custom executable/service paths.

Deployment safety and rollback