Pagesmith
Start building

Hosting Options

Use Pagesmith hosting or adapt an exported Astro project for another supported host.

Pagesmith includes managed hosting. On eligible plans, you can export the Astro project and configure it for another host.

Built-in Hosting

Pagesmith hosting provides:

  • Cloudflare network: Serves the deployed project
  • SSL: Provides HTTPS after domain validation and certificate setup
  • Custom domains: Connects supported domains on eligible plans
  • Versioned publishing: Creates a new deployed version after a successful build
  • Restore controls: Lets you return to an available earlier version

Built-in hosting keeps publishing, domains, and supported Pagesmith services in one workflow.

Self-Hosting Options

Export the project on an eligible plan, then check its output mode, adapter, integrations, environment variables, and data services before choosing another host.

Vercel

Useful when your team already uses Vercel.

  1. Export project from Pagesmith
  2. Push to GitHub
  3. Import in Vercel dashboard
  4. Install the appropriate Astro adapter and configure the project
# Framework: Astro
# Build: npm run build
# Output: dist

Netlify

Useful for static projects that fit Netlify’s deployment model.

  1. Export project from Pagesmith
  2. Push to GitHub
  3. Connect repo in Netlify
  4. Deploy with:
# netlify.toml
[build]
  command = "npm run build"
  publish = "dist"

Cloudflare Pages

Useful when your team already uses Cloudflare.

  1. Export project from Pagesmith
  2. Push to GitHub
  3. Create Pages project
  4. Configure:
Build command: npm run build
Output directory: dist

AWS / S3 + CloudFront

Useful when the project must fit existing AWS infrastructure.

  1. Build locally: npm run build
  2. Upload dist/ to S3 bucket
  3. Configure CloudFront distribution
  4. Set up custom domain

Any Static Host

This works only when the project builds to static files:

  1. Run npm run build
  2. Upload contents of dist/ folder
  3. Configure redirects, headers, domains, and error pages for the host

SSR Hosting

If the site uses server rendering, database access, or server routes, use a compatible Astro adapter and runtime. The snippets below are examples. Confirm current adapter names and settings in Astro’s documentation.

Cloudflare Workers

Astro has native Cloudflare adapter:

// astro.config.mjs
import cloudflare from '@astrojs/cloudflare';

export default defineConfig({
  adapter: cloudflare(),
});

Vercel Edge

Use the Vercel adapter:

import vercel from '@astrojs/vercel/edge';

export default defineConfig({
  adapter: vercel(),
});

Node.js Server

For traditional Node hosting:

import node from '@astrojs/node';

export default defineConfig({
  adapter: node({ mode: 'standalone' }),
});

Domain Configuration

When self-hosting:

  1. Add your domain to the hosting provider
  2. Update DNS records:
    • A record → Provider’s IP
    • CNAME → Provider’s URL
  3. Complete the provider’s domain validation and SSL setup

When to Self-Host

Built-in hosting is useful when:

  • Getting started
  • Don’t need special infrastructure
  • You want to manage publishing and domains in Pagesmith
  • The project uses Pagesmith-managed services

Consider another host when:

  • Corporate infrastructure requirements
  • Need specific provider features
  • Part of larger deployment pipeline
  • You have reviewed the operational cost and migration work