Skip to Content
homemade
Dashboard

Projects and VMs

What you get when you create a project and a VM, and the sizes a VM can have.

A project is your code plus the recipe for running it. A VM is a computer in the cloud that runs that recipe. You can have many VMs per project, for example one per branch or per task.

Create a project

In the dashboard, choose New project and pick where the code comes from:

  • Import a repo. Connect GitHub and pick a repository. If the repo has no .homemade/config, Homemade looks at your lockfiles and compose file and fills in a recipe for you to check.
  • Template. Start from a ready app, such as Next.js, Django, Rails or Laravel. See Configuration.
  • Empty project. Start with nothing and add code from the terminal.

The project's first build prepares everything its VMs need. When it finishes, you can create VMs.

What a new VM has

  • Your repository cloned at the branch you chose, in /workspace/app.
  • Your install commands run, and your services started and running, each in its own terminal.
  • A preview link for every service that publishes a URL. See Previews.
  • Terminals, files, a browser editor, SSH, VS Code and Cursor access, and chat. See AI tools.
  • Your signed-in AI tools, environment variables and integrations.

Create a VM from the dashboard, with homemade vm create, or with the API.

Sizes

Pick a size when you create a VM. If you pick none, a VM gets the project's size, else the plan's default: medium on Pro, tiny on Hobby.

SizeCPUMemoryDiskPer hourPlans
nano0.5 vCPU, shared1 GB10 GB$0.012Hobby, Pro
tiny2 vCPU4 GB20 GB (10 GB on Hobby)$0.0162Hobby, Pro
small4 vCPU8 GB30 GB$0.0324Pro
medium8 vCPU16 GB60 GB$0.0648Pro
large16 vCPU32 GB100 GB$0.18Pro

The disk is part of the hourly price. Enterprise teams can also ask for a custom shape. See Pricing and plans for what you pay.

Stop using a VM

A VM sleeps when you stop using it, and you can put it to sleep yourself. See Sleep and wake. Deleting a VM removes its disk for good.

On this page