A lightweight companion service for Registry Radar that extends its monitoring reach across remote hosts.
Registry Radar Agent continuously monitors Docker containers on remote machines and securely reports their state to a central Registry Radar server.
It’s tightly integrated with the Registry Radar ecosystem and not intended for standalone use.
- 🐳 Docker Container Monitoring – Automatically discovers and tracks all containers running on the host
- ⚡ Real-Time Updates – Instantly reports container state changes (running, stopped, exited)
- 🔍 Automatic Discovery – Detects new containers as they’re created and adds them to monitoring
- 🌐 Multi-Agent Support – Deploy agents on multiple hosts, all reporting to the same Radar server
- 🧩 Automatic Enrollment – Uses one-time enrollment tokens for secure registration
- 🔒 WebSocket + JWT Security – Persistent encrypted communication channel
- 🏷️ Smart Tag Parsing – Handles Docker image names and tags accurately (e.g.,
nginx:1.21,postgres:13-alpine)
- Enrollment – Agent registers with Registry Radar using a one-time enrollment token
- Authentication – Exchanges and renews JWT tokens for secure communication
- WebSocket Connection – Maintains a live channel with the Radar server
- Container Discovery – Scans and catalogs all Docker containers on the host
- Status Monitoring – Subscribes to Docker events for continuous updates
- Data Reporting – Sends structured container data every 30 seconds
| Variable | Description | Example |
|---|---|---|
SERVER_URL |
Registry Radar server endpoint | https://your-registry-radar-host |
AGENT_ID |
Unique identifier for this agent | agent-001 |
AGENT_ENROLL_TOKEN |
One-time enrollment token (from the UI) | abc123xyz |
REFRESH_SECRET |
Persistent refresh secret (set after enrollment) | — |
AGENT_LOG_LEVEL |
Optional logging level (default: info) |
debug |
Agents are deployed via Docker Compose files generated automatically by the Registry Radar web interface.
- Open the Agents tab in Registry Radar
- Click “Add Agent” and provide a name
- Copy the generated Docker Compose snippet
- Deploy it on your remote host
Once launched, the agent will securely connect and begin reporting container data.
- 🔗 Registry Radar Required – The agent only functions with an active Registry Radar server
- 🧭 Not Standalone – It’s a supporting component, not a full monitoring tool
- 🔐 Secure by Design – Uses JWT + enrollment tokens for authentication
- 🐋 Docker Dependency – Requires Docker to be installed and accessible on the host
This project is licensed under the MIT License.
See the LICENSE file for details.
This project was developed with the help of modern AI coding tools to accelerate prototyping and implementation.
- AI assisted in scaffolding, boilerplate generation, and code suggestions
- All code was reviewed, refined, and tested by humans before release
- The use of AI enabled faster iteration, architectural clarity, and higher overall quality
💡 Community feedback and contributions are encouraged to further enhance this project.