> ## Documentation Index
> Fetch the complete documentation index at: https://docker-agent-tail.michaelscotello.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Choose your preferred installation method for docker-agent-tail.

## Install

<Tabs>
  <Tab title="Homebrew">
    ```bash theme={null}
    brew install Mscotello/tap/docker-agent-tail
    ```
  </Tab>

  <Tab title="Go Install">
    ```bash theme={null}
    go install github.com/Mscotello/docker-agent-tail@latest
    ```

    <Note>
      Make sure `$HOME/go/bin` is in your PATH. Add this to your shell profile (e.g., `~/.zshrc` or `~/.bashrc`):

      ```bash theme={null}
      export PATH="$PATH:$HOME/go/bin"
      ```
    </Note>
  </Tab>

  <Tab title="Curl">
    ```bash theme={null}
    curl -sSL https://github.com/Mscotello/docker-agent-tail/releases/latest/download/install.sh | bash
    ```
  </Tab>
</Tabs>

## Verify Installation

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

```bash theme={null}
$ docker-agent-tail --version
docker-agent-tail v0.1.3
```

## System Requirements

<CardGroup cols={3}>
  <Card title="Docker" icon="docker">
    Docker must be installed and the daemon running. Supports Docker 18.0+.
  </Card>

  <Card title="Socket Access" icon="plug">
    Your user must have access to the Docker socket (usually requires membership in the `docker` group).
  </Card>

  <Card title="Log Driver" icon="file">
    Containers must use `json-file` or `journald` log drivers for streaming support.
  </Card>
</CardGroup>

## First Run

Try tailing all running containers:

```bash theme={null}
$ docker-agent-tail --all --follow
[2026-03-04T10:30:01.789Z] [web  ] [stdout] Server listening on :3000
```

Press `Ctrl+C` to exit.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Permission Denied">
    If you get a permission error, add your user to the docker group:

    ```bash theme={null}
    sudo usermod -aG docker $USER
    ```

    Then log out and back in for the change to take effect.
  </Accordion>

  <Accordion title="Docker Socket Not Found">
    Check your Docker installation or set the `DOCKER_HOST` environment variable:

    ```bash theme={null}
    export DOCKER_HOST=unix:///var/run/docker.sock
    ```
  </Accordion>
</AccordionGroup>

## Next Steps

<Card title="Getting Started Guide" icon="arrow-right" href="/quickstart">
  Follow the 5-minute tutorial to learn the basics
</Card>