Deploy a website or front end on Aria

To deploy a website, choose Website when you make a new project and connect its GitHub repository. Aria works out how it builds, gives it HTTPS, and serves it from your own server. A static site is built once and served as files, so it stays small, and several sites can share one plan.

How do I start?

1. Choose New project, then Website.
2. Connect the repository, or a folder on your computer.
3. Let Aria AI write aria.yaml, or write it yourself.
4. Choose a plan, or put the site on a server you already have.
5. Pick its address, then launch.

The full walk-through is the Quickstart.

What does the stack file look like?

One service of type static:

version: 1
name: my-site
services:
  site:
    type: static
    build: npm run build
    domain: "@"

This suits plain HTML, and frameworks that build to static files, such as Astro, Vite, Hugo, Eleventy, Jekyll or a Next.js static export. Every field is in the aria.yaml reference.

What if my site has a backend?

Aria runs it as the full app it is. If the code has a database, a server that renders pages or an API, Aria AI describes those parts too. A front end with its own API is two services:

version: 1
name: my-shop
services:
  web:
    type: static
    path: apps/web
    build: npm run build
  api:
    type: api
    path: apps/api
    port: 8080
    healthcheck: /health
env:
  PUBLIC_API_URL:
    services: [web]
    from: api.url
    build: true

build: true passes the address in while the site is built. Names that start with PUBLIC_, VITE_ or NEXT_PUBLIC_ get this automatically. See Environment variables.

For a server-rendered Next.js app, see Deploy Next.js.

How many sites fit on a server?

Up to 5 projects share one server by default, and a static site needs very little memory once it is built. Each build still needs room for a short while, and Aria counts that when it checks. See Servers and plans.

How do people reach it?

Every site gets a free address you can name, <name>.ariaserver.cloud, with HTTPS. Connect a domain you own, or buy one in Aria. See Domains.

How do updates go out?

Push to the branch you connected. Aria rebuilds and deploys the services your commit touched. Switch this off under Settings, then Code, if you would rather deploy when you ask.