Create a machine

Provision a new development machine

POST

/auth/v1/seed/{namespace}/machines

curl --request POST \
  --url /auth/v1/seed/{namespace}/machines \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"name":"dev-gpu","cloud":"aws","region":"us-east-1","accelerator":"A10G:1","cpus":"4+","memory":"16+","disk_size_gb":100}'

Path parameters

namespace

string

required

The namespace (user or organization) to create the machine in.

Body parameters

name

string

required

A human-readable name for the machine. Must be unique within the namespace. Allowed characters: alphanumeric, hyphens, underscores.

gpu

string

required

GPU type to attach. One of A100-40GB, A100-80GB, H100-80GB, L4, T4, none.

gpu_count

integer

Number of GPUs to attach. Must be 1, 2, 4, or 8.

default: 1

cpu

integer

Number of vCPUs. One of 2, 4, 8, 16, 32, 64, 96.

default: 8

memory_gb

integer

Memory in gigabytes. One of 8, 16, 32, 64, 128, 256, 512.

default: 32

disk_gb

integer

Persistent disk size in gigabytes. Range: 10 to 2000.

default: 100

image

string

Container image to use. Can be a built-in Outpost image or a custom image from your registry.

default: outpost/base:latest

region

string

Deployment region. One of us-east-1, us-west-2, eu-west-1, eu-central-1, ap-northeast-1.

default: us-east-1

repo

string

Full repository name (namespace/repo) to clone into the machine on creation.

env

object

Environment variables to set in the machine, as key-value pairs.

auto_stop_minutes

integer

Automatically stop the machine after this many minutes of inactivity. Set to 0 to disable.

default: 60

ssh_keys

string[]

List of SSH public key IDs to authorize for access. If omitted, all keys in your account are used.

Previous → Machines

Next Delete a machine →