Create

Sailbox.create() boots a fresh VM and lists it under an App. Apps group Sailboxes within your organization. The VM is ready to use as soon as it returns.

sail box create --app my-app --name worker

import sail

app = sail.App.find(name="my-app", mint_if_missing=True)
sb = sail.Sailbox.create(app=app, name="worker")
print(sb.run("echo hello").stdout)

import { App, Sailbox } from "@sailresearch/sdk";

const app = await App.find("my-app", { mintIfMissing: true });
const sb = await Sailbox.create({ app, name: "worker" });
console.log((await sb.run("echo hello")).stdout);

Save the Sailbox ID to connect again later. Disconnecting your client does not terminate the Sailbox.

Resource limits

You do not need to choose a size. By default, each Sailbox has:

Resource	Default
CPU	8 vCPUs
Memory	Up to 64 GiB
Disk	Up to 256 GiB

64-vCPU Sailboxes are in public beta. If you are interested, reach out to us in the community Slack.

These are limits, not reserved resources. You pay for actual usage. Set resource limits on an image to reuse them across creates. To override those limits for one create, pass vcpu_count, memory_limit_gib, or disk_limit_gib in Python; vcpuCount, memoryLimitGib, or diskLimitGib in TypeScript; or --vcpus, --memory-limit-gib, or --disk-limit-gib in the CLI. See create options for supported ranges. Explicit limits round up to powers of two. CPU, memory, and disk limits are independent. You can also change limits later.

Common options

Option	Use it to
`image`	Start from a custom image.
`env`	Set environment variables for commands.
`ingress_ports` / `ingressPorts`	Expose HTTP, TCP, or UDP ports.
`egress_policy` / `egressPolicy`	Restrict outbound connections or inject credentials.
`auto_sleep` / `autoSleep`	Choose when an idle Sailbox sleeps.
`max_lifetime_seconds` / `maxLifetimeSeconds`	Terminate it after a fixed wall-clock lifetime.
`visibility`	Choose organization or private access.

See create options for limits, defaults, and all supported arguments.

Use a custom image

image = sail.Image.debian_amd64.pip_install("requests")
sb = sail.Sailbox.create(app=app, name="worker", image=image)

import { Image } from "@sailresearch/sdk";

const image = Image.debian("amd64").pipInstall("requests");
const sb = await Sailbox.create({ app, name: "worker", image });

The first create may wait for the image to build. Later creates reuse it. See Custom images for Dockerfiles and Compose projects.

Copy an existing Sailbox

Take a checkpoint and start a new Sailbox from it. The copy has its own disk and identity. See Snapshots and forks.

Clean up

sail box terminate <id>

sb.terminate()

await sb.terminate();

Termination permanently deletes the Sailbox. Use sleep or pause when you want to keep it.

Getting started

Inference

Sailboxes

Guides

Security & compliance

Resource limits

Common options

Use a custom image

Copy an existing Sailbox

Clean up

​Resource limits

​Common options

​Use a custom image

​Copy an existing Sailbox

​Clean up

Resource limits

Common options

Use a custom image

Copy an existing Sailbox

Clean up