Skip to content

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.

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

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.