Deploy your first static website to LeafCloud in three quick steps.

Step 1: Install the CLI

Install leaf on your system:

# macOS and Linux
curl -fsSL https://leafcloud.in/install.sh | sh

For Windows PowerShell:

irm https://leafcloud.in/install.ps1 | iex

Verify that the CLI is ready:

leaf --version

Step 2: Sign in

Authenticate leaf with your account:

leaf login

Follow the prompt in your browser to approve the session. When finished, test your authentication:

leaf whoami

If you have an invite code, run leaf invite <code>.

Step 3: Deploy your site

Navigate to your web project directory (Astro, Vite, Next.js static export, Hugo, or plain HTML):

cd my-website

Preview with dry run (recommended)

Before uploading, you can inspect what leaf detects and builds:

leaf deploy --dry-run

Expected output:

Framework: Astro
Package manager: npm
Build command: npm run build
Output directory: dist
Files: 3
Total size: 1716 bytes
Dry run: nothing was uploaded.

Deploy to LeafCloud

When you are ready, deploy your site:

leaf deploy

Create a site before deploying. leaf sites create suggests available names, or set site = "<name>" in a leaf.toml file in your project:

leaf sites create

With no site configured or available, leaf deploy prints Create a site or set site = "name" in leaf.toml before deploying. If multiple sites are available, it prints Set site = "name" in leaf.toml to choose a deployment target.

✓ Live at https://my-website.leafcloud.app  (3 files, 1716 uploaded)

Your site is instantly accessible across edge locations in Bengaluru and Delhi with automatic HTTPS.