Local bindings
Inspect and manage device-local forwards from a workstation to your machine.
A LocalBinding forwards ports and Unix sockets from a workstation to
this device. The binding commands are the primary surface for seeing what is
forwarded, what is in conflict, and turning forwards on and off. Alias: bindings.
Bindings are device-local: they never leave this machine and are never routed or synced, so these commands always operate on the local store.
rl binding show
Show device-local forwards: the actual host ports in use, their sources, and any conflicts.
rl binding show
rl binding show -A # across all namespaces| Flag | Description |
|---|---|
-n, --namespace <ns> | Namespace. |
-A, --all-namespaces | All namespaces. |
--as <subject> | Impersonate a subject. |
--home <dir> | Data directory. |
rl binding enable / disable
Flip a LocalBinding’s master on/off switch (spec.enabled), by name or by label
selector with -l.
rl binding enable my-binding
rl binding disable my-binding
rl binding disable -l tier=dev # every matching binding| Flag | Description |
|---|---|
-l, --selector <k=v> | Label selector (key=value[,key=value]) instead of a name. |
-n, --namespace <ns> | Namespace. |
--as <subject> | Impersonate a subject. |
--home <dir> | Data directory. |
rl binding switch <name> <workstation>
Retarget an existing binding at a different workstation. It rewrites the binding’s
workstationSelector.matchName so the same host ports now forward from another workstation.
rl binding switch my-binding other-box| Flag | Description |
|---|---|
-n, --namespace <ns> | Namespace. |
--as <subject> | Impersonate a subject. |
--home <dir> | Data directory. |
rl binding browser-opens
Show URLs that workstations opened via the www-browser bridge. When a workstation has
browser passthrough enabled, the daemon records each opened URL to
<home>/browser-opens.log; this command prints (or follows) that log.
rl binding browser-opens
rl binding browser-opens -f # follow| Flag | Description |
|---|---|
-f, --follow | Follow the log (stream new opens). |
--home <dir> | Data directory. |