Auto-update

Keeping your agent up-to-date automatically

Overview

The Conexor agent runs as a Docker container. Updates are delivered by pulling a new image from the container registry. You can configure automatic pulls on a schedule, or update manually via standard Docker commands.

How It Works

1. The cloud control plane publishes a new image tag to the registry
2. Your Docker host pulls the new image (docker pull conexor/agent:stable)
3. The container is restarted with the new image — credentials and config are preserved via mounted volumes
4. The agent reconnects to the cloud and resumes serving queries

Manual Update

# Pull the latest stable image
docker pull conexor/agent:stable

# Restart the container with the new image
docker compose pull && docker compose up -d

# Or with plain Docker
docker stop conexor-agent
docker rm conexor-agent
docker run -d --name conexor-agent \
  -v /etc/conexor:/config \
  -e CONEXOR_API_KEY=pk_live_xxxxx \
  conexor/agent:stable

# Pin to a specific version
docker pull conexor/agent:1.3.0

Automatic Updates with Watchtower

Use Watchtower to poll for new images and restart the agent automatically:

docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --interval 86400 \   # check every 24 hours
  conexor-agent

Image Tags

Disabling Auto-update

To opt out of automatic updates, pin your image to a specific version tag (e.g. conexor/agent:1.3.0) and do not run Watchtower or equivalent tooling against the container.