Docker Deployment

Loading the Service

Packet Viewer Service is currently distributed as a tar archive containing a Docker image. To load the image, run:

docker load < packet-viewer-v1.7.0.tar.gz

This command will load the packet-viewer:v1.7.0 image.

Running the service

To quickly start the container and check if it is working, run the following command:

docker run --rm -p 4443:443 -v /my-captures:/data/captures packet-viewer:v1.7.0

Open your web browser and navigate to https://localhost:4443/api/health. Accept the self-signed certificate. This should return the following JSON:

{ "healthy": true }

Environment

The docker image exposes an HTTP server on port 80 and an HTTPS server on port 443 that can be accessed using a web browser. By default Packet Viewer will redirect HTTP traffic on port 80 to HTTPS on port 443.

The /data volume mounted in the Docker container can contain PCAP files under the /data/captures directory and optionally profiles under the /data/profiles directory. Instead of using a volume, PCAP files can also be provided by an S3 bucket.