Skip to main content

​
Install

go install github.com/Mscotello/docker-agent-tail@latest
Make sure $HOME/go/bin is in your PATH. Add this to your shell profile (e.g., ~/.zshrc or ~/.bashrc):
export PATH="$PATH:$HOME/go/bin"

​
Verify Installation

After installation, verify that docker-agent-tail is working correctly: 
$ docker-agent-tail --version
docker-agent-tail version 0.1.0

​
System Requirements

Docker

Docker must be installed and the daemon running. Supports Docker 18.0+.

Socket Access

Your user must have access to the Docker socket (usually requires membership in the docker group).

Log Driver

Containers must use json-file or journald log drivers for streaming support.

​
First Run

Try tailing all running containers: 
$ docker-agent-tail --all --follow
[2026-03-04T10:30:01.789Z] [web  ] [stdout] Server listening on :3000
Press Ctrl+C to exit.

​
Troubleshooting

If you get a permission error, add your user to the docker group:
sudo usermod -aG docker $USER
Then log out and back in for the change to take effect.
Check your Docker installation or set the DOCKER_HOST environment variable:
export DOCKER_HOST=unix:///var/run/docker.sock

​
Next Steps

Getting Started Guide

Follow the 5-minute tutorial to learn the basics