> Documentation index: https://docs.kiste.run/llms.txt, a list of every page in this documentation.

# kiste stream

> Kiste Stream: publish a port of a Kiste at its own address under kiste.stream.

`kiste stream 8888` prints `https://<long-random-name>.kiste.stream`. Anyone with the address reaches the port over HTTP and WebSocket until you stop it; apps keep their cookies, storage and root path there.

```text
kiste stream [OPTIONS] [PORT]
       kiste stream <COMMAND>
```

| Argument | Description |
| --- | --- |
| `[PORT]` | Port inside the Kiste to publish. |

| Option | Description |
| --- | --- |
| `--instance INSTANCE` | Kiste name. Omit to use the current selection. |
| `--description DESCRIPTION` | What runs on the port, shown in the console and to agents. Default: \`\`. |

**Examples**

```text
kiste stream 8888
kiste stream 3000 --instance build
kiste stream ls
kiste stream stop 8888
```

## kiste stream ls

List the ports a Kiste streams, with their addresses.

Aliases: `list`.

```text
kiste stream ls [OPTIONS]
```

| Option | Description |
| --- | --- |
| `--instance INSTANCE` | Kiste name. Omit to use the current selection. |

## kiste stream stop

Stop streaming a port; its address stops answering at once.

```text
kiste stream stop [OPTIONS] <PORT>
```

| Argument | Description |
| --- | --- |
| `PORT` | The published port inside the Kiste. |

| Option | Description |
| --- | --- |
| `--instance INSTANCE` | Kiste name. Omit to use the current selection. |

Global options such as `--json` work with every command; see [the CLI overview](https://docs.kiste.run/cli.md#global-options).

## Related topics

- [Overview](https://docs.kiste.run/cli.md)
- [Output modes and exit codes](https://docs.kiste.run/cli/output.md)
- [Configuration and environment](https://docs.kiste.run/cli/configuration.md)
- [kiste login](https://docs.kiste.run/cli/login.md)
- [kiste logout](https://docs.kiste.run/cli/logout.md)
- [kiste whoami](https://docs.kiste.run/cli/whoami.md)
- [kiste account](https://docs.kiste.run/cli/account.md)
- [kiste new](https://docs.kiste.run/cli/new.md)
- [kiste credentials](https://docs.kiste.run/cli/credentials.md)
- [kiste ssh](https://docs.kiste.run/cli/ssh.md)
- [kiste ssh-config](https://docs.kiste.run/cli/ssh-config.md)
- [kiste exec](https://docs.kiste.run/cli/exec.md)
- [kiste prompt](https://docs.kiste.run/cli/prompt.md)
- [kiste cancel](https://docs.kiste.run/cli/cancel.md)
- [kiste interrupt](https://docs.kiste.run/cli/interrupt.md)
- [kiste command](https://docs.kiste.run/cli/command.md)
- [kiste commands](https://docs.kiste.run/cli/commands.md)
- [kiste desktop](https://docs.kiste.run/cli/desktop.md)
- [kiste list](https://docs.kiste.run/cli/list.md)
- [kiste status](https://docs.kiste.run/cli/status.md)
- [kiste current](https://docs.kiste.run/cli/current.md)
- [kiste watch](https://docs.kiste.run/cli/watch.md)
- [kiste events](https://docs.kiste.run/cli/events.md)
- [kiste stop](https://docs.kiste.run/cli/stop.md)
- [kiste restart](https://docs.kiste.run/cli/restart.md)
- [kiste rename](https://docs.kiste.run/cli/rename.md)
- [kiste update](https://docs.kiste.run/cli/update.md)
- [kiste resume](https://docs.kiste.run/cli/resume.md)
- [kiste extend](https://docs.kiste.run/cli/extend.md)
- [kiste fork](https://docs.kiste.run/cli/fork.md)
- [kiste scp](https://docs.kiste.run/cli/scp.md)
- [kiste forward](https://docs.kiste.run/cli/forward.md)
- [kiste delete](https://docs.kiste.run/cli/delete.md)
- [kiste logs](https://docs.kiste.run/cli/logs.md)
- [kiste image](https://docs.kiste.run/cli/image.md)
- [kiste snapshot](https://docs.kiste.run/cli/snapshot.md)
- [kiste environment](https://docs.kiste.run/cli/environment.md)
- [kiste auth](https://docs.kiste.run/cli/auth.md)
- [kiste devices](https://docs.kiste.run/cli/devices.md)
- [kiste config](https://docs.kiste.run/cli/config.md)
- [kiste completions](https://docs.kiste.run/cli/completions.md)
- [kiste self-update](https://docs.kiste.run/cli/self-update.md)
- [kiste limits](https://docs.kiste.run/cli/limits.md)
- [kiste doctor](https://docs.kiste.run/cli/doctor.md)
- Previous: [kiste environment](https://docs.kiste.run/cli/environment.md)
- Next: [kiste auth](https://docs.kiste.run/cli/auth.md)