Skip to content

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.

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
Google 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.

  • 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.

The .proto files and descriptor sets bodies are decoded with. Add files… adds more. See Protobuf and gRPC.

The proxy lists sessions take an upstream proxy from. See Upstream proxy.

The MCP endpoint, and the command that adds zhttp to an agent, each with a copy button. See AI agents.

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.

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.