Troubleshooting
Something not working as expected? Find the symptom below for what it means and what to do next.
A deploy failed
Section titled “A deploy failed”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.
Your upload was flagged
Section titled “Your upload was flagged”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.
Your archive won’t upload
Section titled “Your archive won’t upload”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.
Your site is asleep
Section titled “Your site is asleep”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.
A custom domain won’t verify
Section titled “A custom domain won’t verify”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 domain went offline
Section titled “A domain went offline”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.
You’re out of AI assists
Section titled “You’re out of AI assists”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.
You hit a plan limit
Section titled “You hit a plan limit”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.
A page shows an error or won’t load
Section titled “A page shows an error or won’t load”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.
Related
Section titled “Related”- Getting help — contact support and other resources.
- Core concepts — projects, deploys, and states explained.