# Deploy a website or front end on Aria

> Host a static site, blog, shop or front end on Aria from GitHub. Aria works out the build, gives it HTTPS, and several sites can share one server.

Source: https://getaria.cloud/docs/deploy-website (updated 1 November 2026)

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](https://getaria.cloud/docs/quickstart).

## What does the stack file look like?

One service of type `static`:

```yaml
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](https://getaria.cloud/docs/aria-yaml).

## 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:

```yaml
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](https://getaria.cloud/docs/environment-variables).

For a server-rendered Next.js app, see [Deploy Next.js](https://getaria.cloud/docs/deploy-nextjs).

## 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](https://getaria.cloud/docs/servers).

## 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](https://getaria.cloud/docs/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.

Next: [Aria Mail: send and receive email from your app](https://getaria.cloud/docs/mail)