Get Started
Create your first sandbox and connect to it in a couple of minutes.
A sandbox is an isolated Linux VM that starts from a template. You create one, connect over SSH or in your browser, do your work, and delete it when you're done.
Before you start
Install the tektona CLI and sign in:
tektona loginConfirm your org and project:
tektona ctx showCreate your first sandbox
A sandbox starts from a template. This example uses Tektona's desktop template so you can open the sandbox in your browser:
tektona sandbox create tektona/desktopIt returns a sandbox id and reaches running in seconds. List your sandboxes:
tektona sandbox lsTo start from an image of your own, build a template from it — see Run a Custom Image, which covers private registries too.
Connect to it
Open the desktop in your browser:
tektona sandbox vnc <sandbox-id> --browserOr get a shell inside the sandbox:
tektona sandbox ssh <sandbox-id>Expose a port
Run something on a port, then mint a shareable preview URL for it:
tektona sandbox preview <sandbox-id> 8080Pass --public at create time for a URL that needs no token. See
Manage Sandboxes for the full command surface.
Clean up
Delete it when you're done:
tektona sandbox rm <sandbox-id>Or pause it to keep its state and free resources, then resume later:
tektona sandbox pause <sandbox-id>tektona sandbox resume <sandbox-id>Where to go next
Run a Custom Image
Build a template from your own OCI image, including private ones.
Egress network policies
Control which domains and CIDRs a sandbox can reach.
Sharing sandboxes
Share a running sandbox with your project, or hand off ownership.
TypeScript SDK
Create and manage sandboxes programmatically with @tektona/sdk.