# Web Interface

> Access the OpenHands CLI through your web browser

## Overview

The `openhands web` command launches the CLI's terminal interface as a web application, accessible through your browser. This is useful when you want to:

* Access the CLI remotely
* Share your terminal session
* Use the CLI on devices without a full terminal

```bash  theme={null}
openhands web
```

<Note>
  This is different from `openhands serve`, which launches the full GUI web application. The web interface runs the same TUI you see in the terminal, just in a browser.
</Note>

## Basic Usage

```bash  theme={null}
# Start on default port (12000)
openhands web

# Access at http://localhost:12000
```

## Options

| Option    | Default   | Description             |
| --------- | --------- | ----------------------- |
| `--host`  | `0.0.0.0` | Host address to bind to |
| `--port`  | `12000`   | Port number to use      |
| `--debug` | `false`   | Enable debug mode       |

## Examples

```bash  theme={null}
# Custom port
openhands web --port 8080

# Bind to localhost only (more secure)
openhands web --host 127.0.0.1

# Enable debug mode
openhands web --debug

# Full example with custom host and port
openhands web --host 0.0.0.0 --port 3000
```

## Remote Access

To access the web interface from another machine:

1. Start with `--host 0.0.0.0` to bind to all interfaces:
   ```bash  theme={null}
   openhands web --host 0.0.0.0 --port 12000
   ```

2. Access from another machine using the host's IP:
   ```
   http://<host-ip>:12000
   ```

<Warning>
  When exposing the web interface to the network, ensure you have appropriate security measures in place. The web interface provides full access to OpenHands capabilities.
</Warning>

## Use Cases

### Development on Remote Servers

Access OpenHands on a remote development server through your local browser:

```bash  theme={null}
# On remote server
openhands web --host 0.0.0.0 --port 12000

# On local machine, use SSH tunnel
ssh -L 12000:localhost:12000 user@remote-server

# Access at http://localhost:12000
```

### Sharing Sessions

Run the web interface on a shared server for team access:

```bash  theme={null}
openhands web --host 0.0.0.0 --port 8080
```

## Comparison: Web Interface vs GUI Server

| Feature      | `openhands web` | `openhands serve`   |
| ------------ | --------------- | ------------------- |
| Interface    | TUI in browser  | Full web GUI        |
| Dependencies | None            | Docker required     |
| Resources    | Lightweight     | Full container      |
| Best for     | Quick access    | Rich GUI experience |

## See Also

* [Terminal Mode](/openhands/usage/cli/terminal) - Direct terminal usage
* [GUI Server](/openhands/usage/cli/gui-server) - Full web GUI with Docker
* [Command Reference](/openhands/usage/cli/command-reference) - All CLI options


---

> To find navigation and other pages in this documentation, fetch the llms.txt file at: https://docs.openhands.dev/llms.txt