> ## Documentation Index
> Fetch the complete documentation index at: https://docs.docketqa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Docket Tunnel

> Test your local development environment with Docket

### Overview

The Docket Tunnel lets you run tests against your local development environment—across **Web, iOS, and Android**—without exposing it to the public internet. Only your authenticated Docket account can access the proxied services. If your laptop can hit it, Docket can test it.

### Install the CLI

Download and install the Docket CLI from our official distribution:

```bash theme={null}
curl -fsSL https://api.docketqa.com/tunnel/install | bash
```

Add the CLI to your PATH:

```bash theme={null}
export PATH="$HOME/.docket/bin:$PATH"
```

> **Tip**: Add the export line to your shell profile (`~/.bashrc`, `~/.zshrc`, etc.) to make it permanent.

### Authenticate

Link the CLI to your Docket account. This account will be the only one with access to services exposed over the tunnel:

```bash theme={null}
docket auth
```

### Start the Tunnel

Start the tunnel to automatically proxy traffic to your local services:

```bash theme={null}
docket start
```

While the tunnel is running:

* Your local services are accessible from within your authenticated Docket account
* Resources are **not** accessible from the public internet or any other Docket account
* Press `Ctrl+C` to stop the tunnel

### Pointing Tests at Your Tunnel

* **Web**: set the test's **URL** to your local address (e.g. `http://localhost:3000`).
* **iOS / Android**: apps that already talk to a private host just work. To jump to a private web app, use a **Deep Link** step.

<img src="https://mintcdn.com/docket-dcd24ade/gDBlXE5yuV3LVuWU/images/Screenshot_2026-05-28_at_4.23.44_PM.png?fit=max&auto=format&n=gDBlXE5yuV3LVuWU&q=85&s=45c2311921f543cc595477c8d77535ad" alt="iOS test using a localhost deep link through the Docket tunnel" width="3125" height="1336" data-path="images/Screenshot_2026-05-28_at_4.23.44_PM.png" />
