---
title: Deploy a static site
description: Deploy built web pages as a site with an HTTPS address.
url: https://agentlab.cresclab.com/docs/en/deploy/static-site
language: en
updated: 2026-10-06
---

# Deploy a static site

Deploy built web pages as a site with an HTTPS address.

## Before you begin

- Your built files, such as the `dist/` folder that `npm run build` creates.
- Permission to create apps. Only administrators can create apps.

If you upload a zip, create it from inside the folder so that `index.html` is at the top of the zip:

```bash
cd dist
zip -r ../site.zip .
```

> [!WARNING] Common mistake
> Zipping the `dist` folder itself puts the page at `dist/index.html`. Without an `index.html` at the top, the version is refused.

## 1. Create an app

1. **Open Deploy › Apps** Select **Create app**.
2. **Enter a name and an address label** Use lowercase letters, numbers and hyphens, for example `launch-page`.

> [!NOTE] Address labels are never reused
> Even after the app is deleted, no other organization gets its address. Check the spelling before you create the app.

## 2. Upload

**Console**
On the app's **Deploy** tab, drop a folder, a `.zip` or an `index.html` on the upload area (or choose one), then select **Upload and build**.

The platform builds a new version and, before it can go live, scans the files for secrets and personal data.
**AI tool**
In an AI tool connected to Agent Lab MCP, type:

```prompt
Deploy dist/ to the Agent Lab app launch-page. Show me the preview address first, and wait for my OK before going live.
```

See [Deploy with an AI tool](https://agentlab.cresclab.com/docs/en/deploy/ai-agent.md) to set it up.

## 3. Go live

An app's first version goes live on its own once it builds. Visitors see it at the public address:

```text
https://launch-page--acme.hosting.agentlab.run
```

Later versions don't go live on their own. Open a version's preview address to check it, then select **Go live** on the **Deploy** tab.

## Next steps

- [Versions, going live and rolling back](https://agentlab.cresclab.com/docs/en/deploy/versions.md)
- [Addresses and access](https://agentlab.cresclab.com/docs/en/deploy/addresses.md): to show the site to a few people only, make the app private with a password.