Skip to content
Start UI Start UI Start UI Documentation

Deploy on Clever Cloud Guide

Deploy on clever cloud

Section titled “Deploy on clever cloud”

This guide explains how to deploy your start-ui-v3 project to Clever Cloud using the Clever Tools CLI.

  1. Create a new Clever Cloud application

    • Go to the Clever Console and select your personal organization or the organization where you want to create your app.

    • Click on “Create…” and select “an application”.

    deploy-on-clever-1

    • Select “Create a brand new app”
    • Select “NodeJS & Bun” as the template.

    deploy-on-clever-2

    • Choose the recommended machine for your project, but you can edit it later.
    • Give a name to your app (description is optional).

  2. Configure environment variables Replace all variables as needed to match your project (including your domain)

    • In the left sidebar, open your project and click Environment Variables.
    • At the top right, select the Expert tab.
    • Paste the environment variable template provided below.
    • Once done, switch back to the Simple view to see your variables listed.

    deploy-on-clever-3

    # Clever Cloud variables
    CC_CACHE_DEPENDENCIES="false"
    CC_CUSTOM_BUILD_TOOL="pnpm install && pnpm build"
    CC_NODE_BUILD_TOOL="custom"
    CC_NODE_DEV_DEPENDENCIES="install"
    CC_PRE_BUILD_HOOK="npm install -g pnpm"
    CC_RUN_COMMAND="pnpm start || (npm install -g pnpm && pnpm start)"
    

    # Start-UI required variables
    AUTH_SECRET="REPLACE ME"
    AUTH_SESSION_EXPIRATION_IN_SECONDS="2592000"
    AUTH_SESSION_UPDATE_AGE_IN_SECONDS="86400"
    DATABASE_URL="REPLACE_ME"
    EMAIL_FROM="Start UI <noreply@example.com>"
    EMAIL_SERVER="smtp://your-smtp-server"
    NODE_ENV="production"
    GITHUB_CLIENT_ID="REPLACE ME" #optional if NODE_ENV != production
    GITHUB_CLIENT_SECRET="REPLACE ME" #optional if NODE_ENV != production
    VITE_BASE_URL="REPLACE ME"
    

    # Optional
    VITE_ENV_NAME="PROD-STAGING-YOUR_ENV"
    VITE_PORT="3000"
    

    VITE_ENV_EMOJI="🚧"
    VITE_ENV_COLOR="gold"
    VITE_IS_DEMO="false"

  3. Deploy your app:

    • Open a terminal in your project
    Terminal window
      npm install -g clever-tools
      clever login
      clever link app_YOUR_ID_APP
      clever deploy

🎉 Once the deployment command completes successfully, your app will be live on Clever Cloud !