devmachine

Real examples

Try it on your own computer first

Run a virtual machine on your computer and use it exactly like a VPS: set it up, make workspaces, add packages, open them. Nothing to buy, and you can throw it away when you are done.

You need: a Mac or Linux computer and Lima, which runs the virtual machine: brew install lima.

1. Create the machine

devmachine machines create-local sandbox

It prints the machine’s address, its port and the root password:

sandbox      127.0.0.1                    port 60022  admin: root
It has no key on it yet, and the root password is "devmachine".

The machine arrives the way a bought server does: reachable as root with a password, and no key yet. The password is public on purpose — this machine holds nothing real.

2. Set it up

If this is your first machine:

devmachine setup

If you already have a machine configured, add this one next to it:

devmachine machines add

Answer with what step 1 printed: address 127.0.0.1, login root, the port it showed, and the password when asked. Everything else is the same as on a real server: the fingerprint check, the key, password logins turned off.

3. Use it like a VPS

devmachine workspaces new alice --machine sandbox
devmachine packages add claude-code --workspace alice
devmachine sync --machine sandbox
devmachine ssh alice

--machine sandbox is needed only when you have more than one machine.

What does not work on a local machine

The internet cannot reach a virtual machine on your computer, so dns, HTTPS certificates and expose do not work there. Everything else does. To see an app you run in the VM, use a tunnel instead of a URL:

devmachine tunnel alice 3000

Stop it, start it, throw it away

devmachine machines stop sandbox
devmachine machines start sandbox
devmachine machines delete-local sandbox

delete-local destroys the VM and everything in it. Then take it out of your configuration: first its workspaces with devmachine workspaces rm alice, then the machine with devmachine machines rm sandbox — it refuses while a workspace still points at it.

Check it: devmachine doctor --machine sandbox passes every line after step 2.

Source: Lima