Sessions and ports
A session is one proxy port and the traffic that came through it. Each has a tab under the top bar. Point two phones at two sessions and their traffic stays apart.
Start a session
Section titled “Start a session”Click + at the end of the tabs.
| Field | |
|---|---|
| Port | Filled in with the next free port above the highest in use. zhttp skips 8878, its MCP port. |
| Name | Optional. Shown on the tab; you can change it later. |
| Upstream proxy | Optional. See Upstream proxy. |
Start (Enter) tries the port and the proxy first. If either is wrong, the dialog stays open and says why, for example Port 8879 is already used by another session. Cancel (Esc) closes it.
The tab
Section titled “The tab”The tab shows the session’s name, or its port until you name it. Its light:
| Light | Means |
|---|---|
| Grey | Starting, or paused |
| Mint | Capturing |
| Amber | Holding a message at a breakpoint |
| Red | Its port wouldn’t open |
A globe means the session goes through an upstream proxy, and a gauge that its network conditions are on. Hover either to see which.
Right-click a tab:
- Rename, or double-click the tab. Enter keeps the name, Esc cancels. Once a session has a name, its port is shown dimmed beside it. AI agents see the name too.
- Upstream proxy…
- Close. The × on the tab and a middle click on it do the same. The last session can’t be closed.
What’s kept
Section titled “What’s kept”When zhttp restarts, every session comes back on its own port with its name, upstream proxy, SSL proxying settings, block and allow lists, network conditions, No caching, breakpoint, map and script rules, smart actions and script variables, and with the traffic it captured and your favourites, highlights and comments in it.
To start each run with empty sessions, turn off Keep traffic when zhttp closes under Settings → General. The traffic is then deleted when zhttp closes; export what you need first.
A session whose port is now taken by another program isn’t moved to another port. Its tab turns red and the list shows Port 8877 could not be opened with the reason. Close the other program, or close the session and start one on a free port.