HTTPS and sharing

Every VM is served at https://<vm>.turm.dev. The edge terminates TLS with an automatic certificate and forwards the request to port 80 in the VM.

# in the VM
python3 -m http.server 80

Then open https://demo.turm.dev.

Change the port

ssh turm.dev share port demo 3000

Who can open it

A new VM’s URL is private: only you can open it, after signing in. Open it up in any of these ways:

ssh turm.dev share set-public demo            # anyone
ssh turm.dev share add demo friend@example.com # one person, by email
ssh turm.dev share add-link demo              # anyone with the link

Undo them with share set-private, share remove <vm> <email> and share remove-link <vm> <token>. share show <vm> lists the current access.

share add <vm> <email> --root also lets that person SSH into the VM.

Note

For signed-in visitors, the proxy adds X-Agentcloud-User-Id and X-Agentcloud-User-Email headers to the request, so your app can tell who is calling. It strips any copies a client sends.

Custom domains

To serve the VM on your own domain, see Custom domains.