Docker Obkio Agent Installation Guide
- How to install the Obkio Monitoring Agent on Docker
What you are going to learn:
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
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 varible is not required when using permanent storage.
AGENT_ID
: This variable is the Agent ID. requiredAGENT_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, visithttps://agent-api.obkio.com/agent/install/<AGENT_ID>/key/
.
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.