Docker Obkio Agent Installation Guide

Obkio maintains the public image obkio/agent image at DockerHub. This image contains an installer with auto-update that will keep the software up-to-date. The software will be automatically installed in /opt/obkio on every execution. Usually there is no need for a custom Dockerfile to use this image.

$ docker run -d --privileged \
             -e AGENT_ID=<id> \
             -e AGENT_SECRET_KEY=<secret_key> \
             obkio/agent

The Docker image is only available for linux/amd64 and linux/arm64.

To accept incoming connections, you must expose the ports 23999/TCP and 23999/UDP.

The software is stored inside /opt/obkio. By configuring permanent storage, the start-up time will be faster if the latest software release is already installed. Also, the AGENT_SECRET_KEY environment variable is not required when using permanent storage.

• AGENT_ID: This variable is the Agent ID. required

• AGENT_SECRET_KEY: This variable is required only if /opt/obkio is not on permanent storage. The key can be generated only once per agent. When ready, visit https://agent-api.obkio.com/agent/install/<AGENT_ID>/key/.

If the host is Windows or macOS, it is not possible to mark DSCP/TOS settings for the monitoring sessions.

As for all other agent types, some firewall configurations might be required if outbound connections are filtered. Refer to the article Firewall Configurations for more details.