Previews
Every service that publishes a URL gets a preview link. Choose who can open it and what visitors see while a sleeping VM wakes.
A service in your project can publish a URL. Each VM gets its own link for that service, so you can open the running app in a browser tab or send it to someone.
The link
Links look like this:
https://{project}-{vm}-{port}-{org}.onhomemade.com{project}is the project's slug.{vm}is the VM's name, likemisty-fern-142.{port}is the port the service listens on.{org}is your team's slug.
A service gets a link when its config says url: true and names a port. See Configuration. Links for a VM are listed on its page in the dashboard, and the API returns them as urls on the VM.
A VM also has a page without a port in its address, {project}-{vm}-{org}.onhomemade.com. It lists the VM's services as links, and only signed-in team members can open it.
On Pro, the Custom domains add-on serves your VMs on your own domains instead. See Pricing and plans.
Who can open it
Each service has a sharing level.
| Level | Who can open the link |
|---|---|
| Public | Anyone who has the link. This is the default. |
| Organization | Members of the team that owns the VM. |
| Owner only | The person who created the VM. |
Visitors who are not allowed in are asked to sign in. Set the level per service in the project's config:
{
"services": {
"web": { "cmd": "pnpm dev", "port": 3000, "url": true, "share": "authenticated" }
}
}In the file, public, authenticated and owner stand for Public, Organization and Owner only. You can also change the level for a single port on the VM page.
Dev servers just work
The preview passes your app each request as if it came to http://localhost:{port}. Host checks in tools like Vite, Django, Rails and Next.js accept it without any setup, and redirects to localhost point back to the preview link. If your app needs to see the real address, for example to build absolute URLs, set publicHost: true on the service.
When the VM is asleep
Opening the link of a sleeping VM shows a page that says "This app is asleep".
- If the project has Wake on visit switched on (Project settings), the visit wakes the VM. The page changes to "Waking this app up" and opens the app by itself when it is ready. Link previews and bots never wake a VM, and one VM wakes from visits at most once every 2 minutes.
- If Wake on visit is off, visitors only see that the app is asleep. Members of the team see a Wake it up button on the page.
While a VM is starting for the first time, the page says "Getting this app ready" and also opens the app on its own. A VM that was switched off, or deleted, shows a page that says so. See Sleep and wake.