Upload a website
Put a finished website online from a folder or ZIP file, without GitHub. What to upload, the limits, how a new version works and what the refusals mean.
A finished website, meaning HTML, CSS, JavaScript and images, goes online from your browser. You don't need GitHub or Docker. This page says what to upload, where the limits are and how to replace the site later. Prices and data location are on the HTML hosting page.
Put it online
- In the dashboard, click "Put an app online" and choose "Upload a website".
- Click "Choose a folder" or "Choose a ZIP file". You can also drop either one onto the page. A folder is packed in your browser before it is sent.
- Give the site a name. The name becomes part of the address:
portfoliois online athttps://portfolio.yourname.prod.page.
The files are checked, built into the site and started. The page shows each step and ends with the link.
What to upload
Upload the finished site, the files a browser can open directly.
- The start page has to be called
index.html. - From a project built with Vite, Astro, Hugo or a similar tool, upload the output folder, not the project. It is usually called
dist,build,out,publicor_site. - If the ZIP file has the site in a subfolder, we find it: the
index.htmlclosest to the top is the start page, and folders calleddistorbuildcome first. - If two folders on the same level both have a start page, the upload is refused. Upload only the folder of the site you want online.
Limits
| Limit | |
|---|---|
| ZIP file, or folder once packed | 50 MB |
| Unpacked | 200 MB |
| Files | 5000 |
Large videos and downloads don't belong in the upload. Host them elsewhere and link to them.
How the site is served
- Only files are served. Nothing in the upload runs on our servers, so PHP or a
server.jsis not executed. - A site with pages of its own answers a missing page with your
404.htmlif there is one. - A site that is one
index.htmlwith scripts, as React, Vue and Svelte apps are, gets every unknown path answered withindex.html. Links deep into the app keep working after a reload. - An uploaded website is an app like any other: it counts as one of your plan's apps, sleeps on the free plan after 15 minutes without a visit, and can carry your own domain as a Pro app or on Pro. See Limits.
Upload a new version
Open the website in the dashboard, go to Settings and click "Upload new version". The version that is online stays until the new one is ready. The address doesn't change, and the upload shows in Activity like a push does for code.
We keep the uploaded files for one day. The website itself stays online for as long as you like, but building an old version again after that day asks you to upload it again. Keep your own copy.
When an upload is refused
| The page says | What to do |
|---|---|
| There is no index.html in it | Rename the start page to index.html, or choose the output folder instead of the project |
| There is more than one start page in it | Upload only the folder of the site you want online |
| That is more than 5000 files | You probably chose the whole project with node_modules. Choose the output folder |
| That is more than 50 MB | Leave out large videos or downloads |
| A name in the ZIP file points outside its folder | Pack the folder again with your computer's own ZIP tool |
| We can't read that as a ZIP file | Pack the folder again and upload the new file |
If the site needs more than files
A project that runs code on a server, needs a database or should rebuild on every push goes online from GitHub. See Deploy a GitHub project.
Read next
Add a Deploy on blitz.cloud button to your README
A button for your project's README that opens blitz.cloud with your repository filled in. Get the badge, the link and what happens after the click.
Manage your apps from a terminal with the blitz command
The blitz command lists your apps, puts new ones online from the App Store, a Docker image or GitHub, restarts and pauses them, runs a command inside one, shows their logs and changes their settings. One file, Node.js 18 or newer, an API key.
Connect an AI assistant to blitz.cloud over MCP
Let Claude, ChatGPT, Cursor, VS Code or any MCP client deploy and manage your apps on blitz.cloud. Sign in with your blitz.cloud account or use an API key. Setup, what an assistant can do, and the limits.
Put your first app online today.
Start on the free plan, no credit card. Move to Pro when an app has to stay online.
Put your app online