Settings
Open Settings with the gear at the right end of the top bar, Ctrl , (Cmd , on a Mac), or Open settings in the command palette. Settings apply to every session and are kept between restarts. A session’s own settings are on the buttons at the right end of its tab row.
General
Section titled “General”| Setting | |
|---|---|
| Theme | System follows the computer’s light or dark mode. Light or Dark keeps one. |
| Show the inspector under the requests | Puts the inspector across the whole window, under the structure and the list. See The window. |
| Show the request and response side by side | In the Request / Response tab, puts the two beside each other instead of one above the other |
| Keep traffic when zhttp closes | On by default. Off, each run starts with empty sessions. See Sessions. |
| Send crash reports | On by default. When zhttp crashes, it sends its developers a report: the version, the operating system, and where in zhttp’s code it failed. A report never includes your traffic. Off, nothing is sent. |
Serve the certificate at http://zhttp.test/ssl |
On by default. Off, a device gets the certificate from the setup page at the computer’s address instead. See Capture a device. |
| DNS | Which DNS server looks up the servers’ names. See below. |
| Choice | Looks names up with |
|---|---|
| Operating system | This computer’s own settings |
| Cloudflare | 1.1.1.1 |
8.8.8.8 |
|
| Custom | The server you type: an IP address such as 9.9.9.9, tls:// and a host for DNS over TLS such as tls://dns.quad9.net, or an https:// address for DNS over HTTPS such as https://dns.quad9.net/dns-query |
If zhttp can’t use a custom server, it says why under the box and keeps using the one before. Through an upstream proxy, the proxy looks names up instead.
Certificates
Section titled “Certificates”- zhttp CA: the certificate authority’s name and SHA-256, and Trust on this computer. See Capture a device.
- Client certificates: certificates zhttp presents to servers that ask for one. See Client certificates.
Protobuf
Section titled “Protobuf”The .proto files and descriptor sets bodies are decoded with. Add files… adds more. See Protobuf and gRPC.
Proxies
Section titled “Proxies”The proxy lists sessions take an upstream proxy from. See Upstream proxy.
AI agents
Section titled “AI agents”The MCP endpoint, and the command that adds zhttp to an agent, each with a copy button. See AI agents.
Extensions
Section titled “Extensions”The extensions installed, each with its version, what it does and a switch, and why one isn’t running when it should be. Open folder opens the folder extensions go in. See Extensions.
Account
Section titled “Account”The email address you’re signed in with. Sign out signs you out of zhttp on this computer, then reopens it at the sign-in.
The version zhttp is running. What’s new beside it lists what every release changed, newest first.
Check for updates looks for a newer one now; zhttp also looks when it starts and once a day. An update downloads by itself, then Update to … appears at the top left of the window. Click it to see what the update changes. It installs when zhttp closes, or straight away with Restart to update. The first time zhttp opens after an update, What’s new opens by itself with every release you didn’t have yet.