Available instances
POST /computers takes no size name. A computer’s size is the cpu, ram, and disk_size_gb you send. The names below are the sizes the dashboard offers and Orgo’s price list prices.
Omit
cpu and ram and you get 1 vCPU and 4 GB, unless you create from a template, which sets its own size. Omit disk_size_gb and you get your plan’s default disk. Your plan caps each computer, so a size above its ceiling is refused until you add capacity, as described in Accepted values.
A Linux computer boots at 1280x720 unless you pass resolution. Linux is the default operating system. Set os on create to choose another.
Usage
Passcpu and ram when creating a computer to select its size:
The SDKs take a
cpu of 0.5, 1, 2, 4, 8, or 16 and send no disk size, so a computer made with one gets your plan’s default disk. Choose a disk size over HTTP. Leave out ram and cpu and the SDKs send neither, so you get the default size above. SDK versions before 0.0.47 (Python) and 1.0.22 (TypeScript) default to 2 GB, which the API rejects, so pass ram and cpu to those.The TypeScript SDK ships in version 1 of the orgo npm package. Install it with npm install orgo@1. Version 2 and later of orgo contain only the CLI.Accepted values
POST /computers validates ram, cpu, and os before it provisions anything. A value outside the sets below returns 400 with the accepted set in the message, for example {"error": "cpu must be 0.5, 1, 2, 4, 8, or 16 cores"}. Omit any of the three and you get the default.
Clearing that check is not the whole story. One computer is capped at 4 vCPU, 64 GB RAM, and 300 GB of disk. No plan on sale raises that cap, and add-ons only take you up to it. Your plan’s per-computer ceiling is at or below the cap. See Orgo pricing.
RAM
Integer, optional, in GB. Defaults to4.
Anything else returns
400: {"error": "ram must be 4, 8, 16, 32, or 64 GB"}.
A macOS computer also accepts 12. For os: "macos" the error lists that value too: {"error": "ram must be 4, 8, 12, 16, 32, or 64 GB"}.
Your plan also caps RAM per computer, below the 64 GB cap, and RAM across your account. A request inside the table above can still be refused with
403 on quota grounds. See Orgo pricing for the current limits.CPU
Number, optional, in cores. Defaults to1.
Anything else returns
400: {"error": "cpu must be 0.5, 1, 2, 4, 8, or 16 cores"}.
8 and 16 are in the accepted set, so they clear the value check. They then fail the quota check with 403 and code PER_COMPUTER_CPU_CAP, on every plan on sale. Treat 4 as the real maximum.
OS
String, optional. Defaults tolinux.
Anything else returns
400: {"error": "os must be one of: linux, windows, macos, android, ios"}. A non-Linux computer is placed on a host that can boot that guest, so capacity for it is narrower than for Linux.
Resolution
Resolution is passed as a string inWIDTHxHEIGHTxDEPTH format. Default is 1280x720x24, or 1920x1080x24 on macOS. A computer created from a template uses the template’s resolution.
Persistence
A computer’s disk and files persist across stop/start. Stopping a computer archives its disk. Starting it again restores your files and installed software, on the same host when Orgo can place it there. If it lands on another host, its IP can change. In-memory state and running processes are not preserved. Computers run until you stop them or turn on auto-stop. A free trial computer stops after 30 minutes.Included with every instance
All instance types share these capabilities:- Full REST API and SDK access
- Screenshot, mouse, keyboard, and bash execution
- File upload and download
- VNC access
Plans
Instance type sets the resources of one computer. How many computers you can run, how much RAM and storage they draw from in total, and how many seats your team gets are all properties of your plan. Plans change, so this page does not restate them. See Orgo pricing for current limits and pricing.Scaling and limits
Your Usage page (the gauge button at the bottom of the sidebar, orhttps://www.orgo.ai/account?tab=usage) shows what you have in use against your limits and lets you add computers, RAM, vCPU, and storage to your account.
If you’re planning a large or sustained fleet, reach out and we’ll provision for it.