> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shardcloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Static HTML Hosting Guide

> Learn how to deploy static HTML websites on ShardCloud platform.

# Getting Started with Static HTML Hosting

Deploy your static HTML websites on ShardCloud with minimal configuration and maximum performance.

Under the hood, we run a production-configured NGINX server to serve all your static files.

<Info>
  ShardCloud supports static HTML websites with fast CDN delivery and automatic optimization.
</Info>

## Prerequisites

Before uploading your static website, ensure you have the following project structure ready.

<CardGroup cols={2}>
  <Card title="Required Files" icon="circle">
    Essential files for deployment
  </Card>
</CardGroup>

## Required Files

Your static HTML website must include these two essential files:

### 1. Entry Point File

* **File**: `index.html` or your main HTML file
* **Purpose**: Main website entry point
* **Requirements**: Valid HTML document that serves as your homepage

### 2. ShardCloud Configuration

* **File**: `.shardcloud`
* **Purpose**: Platform-specific deployment settings
* **Requirements**: Plain text configuration file in root directory

<Warning>
  Both files are mandatory. Missing any of these files will prevent successful deployment.

  ity!
</Warning>

## ShardCloud Configuration

The [.shardcloud](/config) file configures your website deployment settings.

### Configuration Example

```bash theme={null}
DISPLAY_NAME=mystaticwebsite
DESCRIPTION=a simple static html website
MAIN=index.html
MEMORY=128
VERSION=LATEST
SUBDOMAIN=static
```

<Note>
  Static websites require minimal memory since they're served directly without server-side processing.
</Note>

## Deployment Process

<Steps>
  <Step title="Prepare HTML Files">
    Ensure your index.html and supporting files are ready
  </Step>

  <Step title="Configure Platform">
    Create .shardcloud file with deployment settings
  </Step>

  <Step title="Create Archive">
    Zip or RAR your project
  </Step>

  <Step title="Upload via Dashboard">
    Use[ ShardCloud dashboard ](https://shardcloud.app/dash)to upload your archive
  </Step>

  <Step title="Deploy & Serve">
    Website immediately becomes available via CDN
  </Step>
</Steps>

## Common Configuration Examples

### Personal Portfolio

```bash theme={null}
DISPLAY_NAME=portfolio-site
DESCRIPTION=Personal portfolio website
MAIN=index.html
MEMORY=128
VERSION=LATEST
SUBDOMAIN=portfolio
```