Skip to main content

Setup

1

Install the Tensorlake CLI

This installs the tl CLI, which you can use to manage sandboxes and other resources from the command line.
2

Authenticate

After you run tl login, you can manage your sandboxes in the Tensorlake Dashboard. You can also create API keys there for sandbox connections. See Authentication for the full API key setup flow.

Run your first sandbox

Create a tiny sandbox for a quick task, or provision one with more CPU and memory for heavier workloads.

Configure CPU, Memory, Disk, and Timeout

You can specify CPU, memory, disk, and timeout parameters when creating sandboxes. The defaults are 1 CPU, 1024 MB memory, 10 GB disk, and 600 seconds timeout.

Suspend and Resume

Tensorlake sandboxes can be suspended and resumed. A resumed sandbox continues from the exact memory and file system state, it was suspended. This is useful when you want to preserve the sandbox state without paying for idle compute time. You have to name a sandbox to make them suspendable after timeout. Sandboxes without a name are ephemeral and thrown away after the timeout.

Sandbox Checkpoints

Checkpoints are point in time snapshot of a sandbox that you can use to start new sandboxes from.

Terminate Sandboxes

SSH Access

You can also SSH into your sandboxes for an interactive terminal experience.
This uses a WebSocket-backed PTY session to connect you to the sandbox. For programmatic access, you can create and control PTY session with the Python and TypeScript SDKs.

Next Steps

Lifecycle

Understand the different states and behaviors of sandboxes.

Commands

Run shell commands and stream output.

Sandbox Images

Use and customize sandbox images for your use case.