Skip to content

Troubleshooting

Something not working as expected? Find the symptom below for what it means and what to do next.

Open the project and read its deploy report — it explains what the agent tried and where it stopped. From there you can:

  • Ask AI Assist to fix it — describe the problem in chat and let the agent retry.
  • Redeploy yourself, adding a note in the deploy context about what to change.
  • Start another deploy from scratch.

If the deploy was stopped because your upload was flagged, Ask AI Assist and Redeploy won’t appear — see Your upload was flagged below.

If the message says the service is temporarily unavailable, that’s a passing hiccup, not a problem with your app — wait a moment and try again. See Track a deploy for reading the report.

Every archive is scanned for malware before anything runs. If it’s flagged, the deploy stops and the container is removed — you can’t redeploy the same file, so upload a clean archive as a new project. If instead the scanner couldn’t finish the check, try uploading again, and contact support if it keeps happening.

Uploads must be a .zip, .tar, .tar.gz, .tgz, .rar, or .7z file, up to 100 MB. If yours is a different format or larger, repackage it and try again. If the upload drops partway through, it’s usually a network issue — select Try again. You can also connect a Git repository instead — see Deploy a project.

On the Free plan a project auto-pauses after a stretch of inactivity to save resources, and you can pause any project yourself. A sleeping project stays asleep until you wake it — it doesn’t wake from incoming traffic. Open the project and select Wake up. See Pausing and resuming projects.

Your card shows a placeholder instead of a preview

Section titled “Your card shows a placeholder instead of a preview”

The image on a project card is a snapshot, not your live site. A branded placeholder appears when the snapshot hasn’t been captured yet, failed to load, or you’ve hidden previews — your site itself is unaffected. Open the project’s URL to see the live app.

DNS changes can take up to 48 hours to spread across the internet. Re-check that the A record points to the IP address shown in the domain dialog, then select Verify DNS again. See Connect a custom domain.

A connected domain can be paused for two reasons. A billing change may have left it over your plan’s limit — restore it once you have room under the limit. Or its project is paused — the domain returns on its own when you resume the project. See Managing custom domains.

Assists power deploys, redeploys, and AI Assist chat. When you run out, buy a credit pack (on Maker and Pro) or upgrade your plan — pack credits don’t expire. See Using AI Assist.

Plans cap things like active projects, deploys, redeploys, and saved versions. When you reach one, you’ll see a prompt to upgrade — or you can free up room, for example by deleting a project to reclaim a slot. See Plans and billing.

If you see Something went wrong, select Retry, or Home to return to your dashboard. Page not found means the address doesn’t exist — use Back to home. If it keeps happening, check your internet connection.