How to Host Astro Applications

Introduction

This guide covers deploying Astro applications on Shard Cloud. Astro is a modern static site generator with optional server-side rendering.

Creating Your Project

Ensure you have Node.js (16+) and npm installed.

Creating a New Astro Project

npm create astro@latest
cd my-astro-site
npm install

Building Your Project

Build the production output:

npm run build

This creates a dist/ folder with static files.

Serving Your Astro Site

Static Sites (Default)

For static Astro sites, use serve:

.shardcloud

DISPLAY_NAME=Astro Site
DESCRIPTION=Astro Static Site
LANGUAGE=node
MEMORY=512
VERSION=recommended
SUBDOMAIN=my-astro-site
CUSTOM_COMMAND=npm run build && npx serve -s dist -l 80

SSR Mode

For server-side rendering with Node.js adapter:

Install the Node adapter:

npx astro add node

Configure astro.config.mjs:

astro.config.mjs

import { defineConfig } from 'astro/config';
import node from '@astrojs/node';

export default defineConfig({
  output: 'server',
  adapter: node({
    mode: 'standalone'
  }),
  server: {
    port: 80,
    host: true
  }
});

Shard Cloud config:

.shardcloud

DISPLAY_NAME=Astro SSR Site
DESCRIPTION=Astro Server-Rendered Site
LANGUAGE=node
MEMORY=512
VERSION=recommended
SUBDOMAIN=my-astro-ssr
CUSTOM_COMMAND=npm run build && node dist/server/entry.mjs

Deploying

Build Your Application

Run npm run build.

Prepare Your Files

Ensure you have:

src/ folder
package.json
.shardcloud
astro.config.mjs

Exclude Unnecessary Files

Remove: node_modules/, dist/, package-lock.json

Create ZIP Archive

Compress your project folder.

Upload to Shard Cloud

Go to Shard Cloud Dashboard and upload.

Additional Resources

Visit the official Astro documentation for more information.

Troubleshooting

Build errors

Check for component syntax errors and ensure all dependencies are installed.

SSR not working

Verify the Node adapter is properly configured and the output mode is set to ‘server’.

Introduction

Platform Features

Bot Platforms

API Frameworks

Website Frameworks

How to Host Astro Applications

Introduction

Creating Your Project

Creating a New Astro Project

Building Your Project

Serving Your Astro Site

Static Sites (Default)

SSR Mode

Deploying

Additional Resources

Troubleshooting

​Introduction

​Creating Your Project

​Creating a New Astro Project

​Building Your Project

​Serving Your Astro Site

​Static Sites (Default)

​SSR Mode

​Deploying

​Additional Resources

​Troubleshooting

Introduction

Creating Your Project

Creating a New Astro Project

Building Your Project

Serving Your Astro Site

Static Sites (Default)

SSR Mode

Deploying

Additional Resources

Troubleshooting