Skip to content
Trippy

Run Trippy with Docker

Trippy is distributed as the fujiapple/trippy image on Docker Hub. The image bundles the trip binary compiled against Alpine Linux and configures it as the container entrypoint.

Quick start

Section titled “Quick start”

Run the image interactively and pass any CLI arguments directly after the image name:

Terminal window
docker run -it --rm fujiapple/trippy example.com

To display the built-in help you can pass standard flags:

Terminal window
docker run -it --rm fujiapple/trippy --help

Configuration

Section titled “Configuration”

To provide a configuration file, mount host directories into the root of the container:

Terminal window
docker run -it --rm -v "/path/to/trippy.toml:/trippy.toml" fujiapple/trippy example.com

Networking considerations

Section titled “Networking considerations”

Trippy uses raw sockets to send probes. On Linux hosts Docker grants the required CAP_NET_RAW capability by default, so no additional flags are needed.

When running inside more restrictive container runtimes ensure that the container retains this capability:

Terminal window
docker run -it --rm --cap-add=NET_RAW fujiapple/trippy example.com