Reference · Error codes

HSX_E_DEV_PORT_IN_USE

Dev server port already in use.

What this error means

The local dev server could not bind its port on 127.0.0.1 because another process is already listening there.

When this error stops a command, hs-x exits with code 1. With --json, the failure is reported as a structured error whose code field is HSX_E_DEV_PORT_IN_USE — stable to match on in scripts and agents.

Likely causes

  • Another hs-x dev session is still running (possibly in another terminal)
  • A different process is bound to the port (default 8787)

How to fix it

  • Run hs-x dev status to check for an active dev session
  • Stop the other session, or clear its overrides with hs-x dev cleanup
  • Start this session on a free port: hs-x dev --port <n>

Still stuck? Re-run the command with --debug for the wire-level detail, or hs-x doctor to check accounts, link state, and connectivity in one pass.

Keep going