Install GoReplay and capture live HTTP

Binaries and source install for Linux, macOS, and Windows. After install, capture traffic with gor --input-raw. No app changes, no sidecar for the default path.

System requirements

Operating System

Linux, macOS, or Windows

Permissions

Root/Administrator access for traffic capture

Memory

Minimum 256MB RAM

Disk Space

50MB free space

Installation

Download the latest release
Extract the archive
Move to system bin directory

Terminal


          wget https://github.com/buger/goreplay/releases/download/v1.3.3/gor_1.3.3_x64.tar.gz
tar -xzf gor_1.3.3_x64.tar.gz
sudo mv gor /usr/local/bin/

Build from source

You need a recent Go toolchain (1.16+ is the historical floor; use current stable). On Linux/macOS you also need libpcap headers. See compile from source for libpcap and Docker details.

git clone https://github.com/buger/goreplay.git
cd goreplay
make

That produces a gor binary in the current directory. Put it on your PATH, for example sudo mv gor /usr/local/bin/.

Verify

gor --version is not a flag. Print help; the banner includes the version (this checkout reports v2.0.0):

gor --help | head

# Capture HTTP on port 8080 and print it (needs root or CAP_NET_RAW)
sudo gor --input-raw :8080 --output-stdout

You should see raw HTTP requests as they hit the port. If the capture is empty, you are probably looking at the wrong port, capturing TLS, or missing pcap permissions. Next: capturing and troubleshooting.

Learn inputs and outputs, then capture, save to a file, and replay to staging.

Next Steps

Now that you have GoReplay installed, explore these resources to get started: