Launch your first machine
This page takes you from nothing to a shell on a machine that stops itself when nobody is using it.
1. Sign in
Section titled “1. Sign in”Sign in to the console and open your account.
Install the CLI and sign in. If you have not done that yet, get started with the CLI first.
2. Launch it
Section titled “2. Launch it”In Machinery, open Machines and choose Add, or press A. New Machine lists what the launch will use as rows: Kind, Worker pool, Place, Region, Zone, Size, Auto-stop and Name. Give the machine’s assistant a first task in the prompt and choose Launch.
The machine shows in the list at once, launching, as a worker in the account’s default worker pool.
deployport machinery createThe machine runs on Deployport Compute, as a worker in the account’s default worker pool. The command follows the launch until the machine is usable, then prints the machine’s id and the command that opens a shell on it. Add --name to give it a name you will recognize in a list, or --prompt to give its assistant a first task:
deployport machinery create --prompt "build a minimalistic website that says Hi"Choose where a machine runs names a platform, a region and a zone, and run machines in a worker pool creates one in a pool of your own.
3. Open a shell
Section titled “3. Open a shell”Open the machine from the list. Its page shows the ways in, and the ssh command to copy names the host the machine answers on.
deployport machinery ssh <machine-id>A stopped machine starts when you connect, so you do not have to check whether it is running first.
See what you have
Section titled “See what you have”deployport machinery listIf everything worked, the machine’s id is on its own row, and the console’s Machines list shows the same machine reading Online:
ID NAME HOSTNAME SUBSCRIPTION KIND AUTO-STOPmach_kxpkzlq4qf dev-box ip-172-31-4-8 wpool_k3jx9q2m worker offThe ID is the machine’s id. Save it. SUBSCRIPTION is the worker pool it runs in, or - when its vCPU, memory and disk are its own. KIND is what it is for. AUTO-STOP reads on, off, or waiting for the AI harness to finish a task while Mecha is working.
What happens when you walk away
Section titled “What happens when you walk away”Auto-stop ships off, so a new account pays for a machine that sits idle. Turn it on for every machine in the account, once:
In Machinery, open Settings, then the Power section, and turn on the idle alarm and auto-stop.
deployport machinery account-settings set-power --idle-alarm-enabled true --auto-stop-enabled true --auto-stop-heads-up-enabled true --auto-stop-heads-up 2mA machine with auto-stop on stops itself when it has been idle, and the bill stops with it. It warns you first, so you get a chance to keep it running:
deployport machinery autostop suppress <machine-id> 4hAn ssh session counts as use, so a machine you are working on is never stopped under you. Let a machine stop itself explains the timings, how to turn it on for one machine rather than the account, and how to give the machine back.
Stop it, or destroy it
Section titled “Stop it, or destroy it”A stop keeps the disk and the next start brings the machine back:
deployport machinery stop <machine-id>deployport machinery start <machine-id>A terminate destroys the cloud instance. Nothing brings it back, so the command asks you to accept that:
deployport machinery terminate <machine-id> --yesRun it on another platform
Section titled “Run it on another platform”New Machine has a Place row. Choose it and pick Deployport Compute or UCE, then a region and a zone inside it.
deployport machinery create --hosting-platform uce --region <region>uce places the machine on the clusters you own under our control plane, and a machine there is a desktop. Choose where a machine runs has the whole list of places and the commands that print them.
If the launch or the shell did not work, Machine and ssh failures names the cause.
Next steps
Section titled “Next steps”- Choose where a machine runs names the platform, the region and the zone.
- Set what every machine inherits decides the settings the next machine gets.
- Work with Mecha uses the assistant the machine already runs.