Pushpin Dockerfile

This repository contains Dockerfile of Pushpin for Docker published to the public Docker Hub Registry.

Base Docker Image

• ubuntu:24.10

Installation

1. Install Docker.

2. Download automated build from public Docker Hub Registry: docker pull fanout/pushpin

Alternatively, you can build an image from the Dockerfile. The easiest way to do this is with docker-compose, which picks up the source & image versions from compose.yaml:

docker-compose build

Or you can build with docker and manually specify the versions:

docker build --build-arg VERSION={SOURCE_VERSION} -t fanout/pushpin:{IMAGE_VERSION} .

Usage

docker run \
  -d \
  -p 7999:7999 \
  -p 5560-5563:5560-5563 \
  --rm \
  --name pushpin \
  fanout/pushpin

By default, Pushpin routes traffic to a test handler. See the Getting Started Guide for more information.

Open http://<host>:7999 to see the result.

Configure Pushpin to route traffic

To add custom Pushpin configuration to your Docker container, attach a configuration volume.

docker run \
  -d \
  -p 7999:7999 \
  -p 5560-5563:5560-5563 \
  -v $(pwd)/config:/etc/pushpin/ \
  --rm \
  --name pushpin \
  fanout/pushpin

Note: The Docker entrypoint may make modifications to pushpin.conf so it runs properly in its container, exposing ports 7999, 5560, 5561, 5562, and 5563.

See project documentation for more on configuring Pushpin.