Deploy a frontend

Deploy a Next.js site to Volcano and serve it at a Volcano URL or your own domain. This uses the Volcano CLI; install it and sign in first (see the Quickstart).

1. Scaffold or bring your app

Start a new Next.js project scaffolded for Volcano, or use an existing one:

volcano init nextjs        # new project
# or: cd into your existing Next.js app

Select the project you're deploying to:

volcano projects create my-app
volcano use my-app

2. Set variables

Values your build needs go in project variables. Prefix anything the browser needs with NEXT_PUBLIC_:

volcano variables deploy NEXT_PUBLIC_API_URL=https://api.example.com

3. Deploy

volcano cloud frontends deploy

The CLI uploads your app, Volcano builds it, publishes the assets, and returns the site URL. Watch progress and check status:

volcano cloud frontends list
volcano cloud frontends get my-site

Redeploy after changes — traffic stays on the live build until the new one is ready:

volcano cloud frontends redeploy my-site

4. Add a custom domain

volcano cloud frontends domain create my-site --domain app.example.com
volcano cloud frontends domain get my-site      # follow DNS/verification status

5. View logs

volcano cloud frontends logs my-site

Next

• Frontends overview — how builds, variables, and domains fit together.
• Environment variables — build vs runtime.
• Frontend API reference — deploy over HTTP.