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
Sign in to the Tektona console at https://app-dev.tektona.ai. Create an API key on the API keys page.
Install the tektona CLI and sign in with the key:
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/desktop --name first-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 Templates, and Container Registries for private images.
Connect to it
Open the desktop in your browser:
tektona sandbox vnc first-desktop --browserOr get a shell inside the sandbox:
tektona ssh first-desktopYou can use the ID from tektona sandbox ls instead: tektona 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
Templates
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.