> ## Documentation Index
> Fetch the complete documentation index at: https://allhandsai-cookbook-generated-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 terminal UI experience 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 | Terminal UI 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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.