Installation
Download HTTPeep for your platform, install the root CA certificate for HTTPS interception, and verify the installation with httpeep-cli.
Installing HTTPeep takes about two minutes. The main steps are downloading the app for your platform, trusting the built-in root CA certificate so HTTPeep can decrypt HTTPS traffic, and confirming that the bundled CLI is working. All your data is stored locally at ~/.httpeep/ — nothing is sent to external servers.
System requirements
| Platform | Requirement |
|---|---|
| macOS | macOS 10.15 (Catalina) or later, Apple Silicon |
| Windows | Windows 10 or later, 64-bit |
| Linux | glibc 2.31 or later |
Download and install
Download the macOS build for Apple Silicon:
Open the downloaded .dmg file, drag HTTPeep to your Applications folder, then launch it from Applications or Spotlight.
On first launch, macOS may show a security prompt because the app was downloaded from the internet. Go to System Settings → Privacy & Security and click Open Anyway.
Download the Windows installer:
Run the downloaded .exe file and follow the setup wizard. HTTPeep installs to your user directory by default — no administrator rights are required.
Windows SmartScreen may display an "unrecognized app" warning on first run. Click More info and then Run anyway to proceed.
Download the Linux AppImage:
Mark the file as executable and launch it:
chmod +x HTTPeep-*.AppImage
./HTTPeep-*.AppImageThe AppImage requires glibc 2.31 or later. You can check your version with ldd --version. Most distributions from 2021 onwards meet this requirement.
Install the root CA certificate
HTTPeep includes a built-in root CA that it uses to decrypt HTTPS traffic. You must add this certificate to your system's trust store before HTTPS requests will appear in the traffic list. HTTP traffic is captured without this step.
The root CA is generated locally on your machine and never leaves it. However, trusting a CA allows it to issue certificates for any domain. Only install it on machines you control and trust.
In HTTPeep, go to Settings → Certificate. Click Install Root CA.
macOS opens Keychain Access and prompts you to add the certificate. Enter your system password to confirm.
Find the HTTPeep CA certificate in Keychain Access, double-click it, expand the Trust section, and set When using this certificate to Always Trust. Close the dialog and enter your password to save.
In HTTPeep, go to Settings → Certificate. Click Install Root CA.
Windows displays a security dialog asking whether to install the certificate into the Trusted Root Certification Authorities store. Click Yes to confirm.
In HTTPeep, go to Settings → Certificate. Click Export Root CA to save the .crt file to your filesystem.
The exact command depends on your distribution:
sudo cp httpeep-ca.crt /usr/local/share/ca-certificates/httpeep-ca.crt
sudo update-ca-certificatessudo cp httpeep-ca.crt /etc/pki/ca-trust/source/anchors/httpeep-ca.crt
sudo update-ca-trustsudo cp httpeep-ca.crt /etc/ca-certificates/trust-source/anchors/httpeep-ca.crt
sudo trust extract-compatChromium-based browsers on Linux use their own certificate stores. In Chrome or Edge, go to Settings → Privacy and security → Security → Manage certificates → Authorities, then import the exported .crt file and enable Trust this certificate for identifying websites.
Verify the installation
HTTPeep bundles httpeep-cli automatically — you do not need to install it separately. After launching the desktop app at least once, the CLI is available on your PATH.
Confirm it is working:
httpeep-cli --versionYou should see output like:
httpeep-cli 1.x.xOn macOS, the CLI is added to /usr/local/bin/ by the app on first launch. If the command is not found, try opening HTTPeep and then restarting your terminal session.