Run Coordimap Agent With Docker

Run the Coordimap agent with Docker using a mounted YAML configuration file and pinned image tags for repeatable infrastructure discovery.

The Coordimap agent is published as a Docker image on Docker Hub.

Docker image repository:

coordimap/coordimap-agent

Why Use Docker?

This is a good fit when you want to:

run the agent locally for testing
deploy it on a VM that already uses containers
keep installation simple without managing a host binary directly

Before You Start

Prepare a config.yaml file first.

Use these docs as the source of truth:

Pin image tags in production

Avoid latest in production. Pin the agent image to a tested release tag so upgrades are explicit and rollback is predictable.

Pull The Image

Example with a pinned version:

docker pull coordimap/coordimap-agent:v1.2.7

Run The Container

docker run --rm \
  -v "$(pwd)/config.yaml:/config.yaml:ro" \
  -e COORDIMAP_API_KEY="YOUR_API_KEY" \
  coordimap/coordimap-agent:v1.2.7 \
  --config /config.yaml

If your config uses credential placeholders such as ${AWS_ACCESS_KEY_ID} or ${POSTGRES_PASSWORD}, pass those environment variables into the container as well.

Example:

docker run --rm \
  -v "$(pwd)/config.yaml:/config.yaml:ro" \
  -e COORDIMAP_API_KEY="YOUR_API_KEY" \
  -e AWS_ACCESS_KEY_ID="YOUR_ACCESS_KEY" \
  -e AWS_SECRET_ACCESS_KEY="YOUR_SECRET_KEY" \
  coordimap/coordimap-agent:v1.2.7 \
  --config /config.yaml

Recommended Next Steps

Start with one data source and confirm the crawl succeeds.
Verify that each data source has the correct scope_id.
Once validated, move the container definition into Compose, Nomad, or your preferred runtime.