[Feature]: Add --port flag to openhands serve

[emhamitay]

Is there an existing feature request for this?

• I have searched existing issues and feature requests, and this is not a duplicate.

Problem or Use Case

openhands serve hardcodes port 3000 for both the host and container (-p 3000:3000), with no way to override it via a flag. Since 3000 is also the default port for many frontend dev servers (Next.js, Vite, CRA, etc.), this creates an unnecessary conflict for developers who want to run OpenHands alongside their projects.

Proposed Solution

Add a --port option to openhands serve that maps to -p :3000 in the underlying docker command, so users can do:
openhands serve --port 4000
Currently the only workaround is constructing and running the full docker run command manually, which defeats the purpose of the CLI launcher's convenience.

Alternatives Considered

No response

Priority / Severity

Medium - Would improve experience

Estimated Scope

Small - UI tweak, config option, or minor change

Feature Area

Configuration / Settings

Technical Implementation Ideas (Optional)

No response

Additional Context

No response

[VascoSch92]

Hey @emhamitay

thanks for the issue.

This is specifically an OpenHands CLI issue.

openhands serve is implemented in the OpenHands/OpenHands-CLI repo, and the current launcher hardcodes the Docker port mapping as:

-p 3000:3000

The main OpenHands/OpenHands repo is still relevant because the GUI container listens internally on port 3000, but the missing flag belongs to the CLI launcher.

So I'm moving the issue into the OpenHands-CLI repo.