Skip to content
This is an unmaintained snapshot of the Astro v4 docs. View the latest docs.

Deploy your Astro Site to Clever Cloud

Clever Cloud is a European cloud platform that provides automated, scalable services.

Project Configuration

Section titled Project Configuration

You can deploy both fully static and on-demand rendered Astro projects on Clever Cloud. Regardless of your output mode (pre-rendered or on-demand), you can choose to deploy as a static application which runs using a post-build hook, or as a Node.js application, which works out-of-the-box with your package.json.

Port and host

Section titled Port and host

Applications on Clever Cloud listen on port 8080. If your project requires this configuration, set your port and host in Astro in one of two locations:

  1. In package.json scripts:

    package.json
    "scripts": {
      "dev": "astro dev",
      "start": "astro dev",
      "build": "astro check && astro build",
      "preview": "astro preview --host 0.0.0.0 --port 8080",
      "astro": "astro"
    }

  2. In astro.config.mjs:

    astro.config.mjs
    import { defineConfig } from 'astro/config';
    

    export default defineConfig({
      server: {
        port: 8080,
        host: true
      }
    });

Deploy Astro from the Console

Section titled Deploy Astro from the Console

To deploy your Astro project to Clever Cloud, you will need to create a new application. The application wizard will walk you through the necessary configuration steps.

  1. From the lateral menubar, click Create > An application

  2. Choose how to deploy:

    • Create a brand new app: to deploy from a local repository with Git

    or

    • Select a GitHub repository: to deploy from GitHub

  3. Select a Node.js application, or a static one.

  4. Set up the minimal size for your instance and scalability options. Astro sites can typically be deployed using the Nano instance. Depending on your project’s specifications and dependencies, you may need to adjust accordingly as you watch the metrics from the Overview page.

  5. Select a region to deploy your instance.

  6. Skip connecting Add-ons to your Clever application unless you’re using a database or Keycloak.

  7. Inject environment variables:

    • For Node.js, no specific environment variable is needed to deploy Astro if you’re using npm. If you’re using yarn or pnpm, set the following environment variables:
    Terminal window
    CC_NODE_BUILD_TOOL="custom"
    CC_PRE_BUILD_HOOK="npm install -g pnpm && pnpm install"
    CC_CUSTOM_BUILD_TOOL="pnpm run astro telemetry disable && pnpm build"
    CC_RUN_COMMAND="pnpm run preview"
    • For a static application, add these variables:
    Terminal window
    CC_POST_BUILD_HOOK="npm run build"
    CC_PRE_BUILD_HOOK="npm install && npm run astro telemetry disable"
    CC_WEBROOT="/dist"

  8. Deploy! If you’re deploying from GitHub, your deployment should start automatically. If you’re using Git, copy the remote and push on the master branch.

Official Resources

Section titled Official Resources

More Deployment Guides

Contribute

What’s on your mind?

Create GitHub Issue

Quickest way to alert our team of a problem.

Community