Troubleshooting & Support

My Web Terminal Is Frozen or Keeps Disconnecting

By TermSquad · Last reviewed

A frozen-looking terminal can be a browser connection problem, a program waiting for input, or an overloaded computer. Start with the least disruptive checks so you preserve running work.

Check the terminal connection

  1. Click or tap inside the terminal to give it keyboard focus.
  2. Read the connection indicator.
  3. Open Terminal options → Reconnect.
  4. Reopen the same computer’s agent terminal if needed.
  5. Test another network or supported browser if disconnections continue.

On a phone, locking the screen or switching apps can suspend the browser connection. Reconnecting is expected after that suspension.

Is only one program unresponsive?

Switch to another Herdr pane or open a new tab. If a shell works there, inspect the original program’s prompt and output. It may be waiting for approval, provider access, or a long command.

Do not press Ctrl+C repeatedly unless you intend to interrupt that foreground task.

Check the computer

Open Overview and Metrics. Confirm the computer is active, data is fresh, and memory or disk pressure is not blocking work.

If SSH works while the web terminal fails, report that distinction; it helps locate the issue. If both fail, check the computer state and network reachability.

A restart interrupts all processes. Use it only after checking session state and saving what you can; it is not the first step for a browser disconnect.

See reconnecting from another device, resource troubleshooting, and support.