---
sidebar_position: 24
---

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

# `lium port-forward`

Forward a port from a pod to your local machine over the SSH tunnel.

```bash
lium port-forward TARGET PORT [OPTIONS]
```

## Arguments

- `TARGET` — Pod name or index.
- `PORT` — Internal pod port to forward.

## Options

| Flag | Effect |
|------|--------|
| `-l, --local-port PORT` | Local port to bind (default: same as internal port) |

## Examples

```bash
lium port-forward my-pod 8888                # Forward 8888:8888
lium port-forward my-pod 8888 -l 9000        # Forward 8888 → local 9000
lium port-forward 1 22 -l 2222               # SSH on a custom local port
```

The forward stays open until you `Ctrl-C`.

## See also

- [`lium update --jupyter`](./update.md) — open a Jupyter port on a running pod, then forward it
- [`lium ssh`](./ssh.md) — interactive shell over the same tunnel