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 login

Confirm your org and project:

tektona ctx show

Create 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-desktop

It returns a sandbox ID and reaches running in seconds. List your sandboxes:

tektona sandbox ls

To 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 --browser

Or get a shell inside the sandbox:

tektona ssh first-desktop

You 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> 8080

Pass --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

On this page