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
installcommands 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.
| Size | CPU | Memory | Disk | Per hour | Plans |
|---|---|---|---|---|---|
| nano | 0.5 vCPU, shared | 1 GB | 10 GB | $0.012 | Hobby, Pro |
| tiny | 2 vCPU | 4 GB | 20 GB (10 GB on Hobby) | $0.0162 | Hobby, Pro |
| small | 4 vCPU | 8 GB | 30 GB | $0.0324 | Pro |
| medium | 8 vCPU | 16 GB | 60 GB | $0.0648 | Pro |
| large | 16 vCPU | 32 GB | 100 GB | $0.18 | Pro |
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.