Quickstart

Deploy an existing app from your terminal with the user CLI.

1. Add adios.yaml

Create an adios.yaml file at the root of your project:

name: dashboard
region: de
replicas: 1

build_cmd:
  - pnpm build

start_cmd:
  - pnpm start

runtime:
  port: 3000
  health_path: /api/health
  memory_mb: 1024

requires:
  - db

This describes the app, runtime port, health check, resource size, replica count, region, and managed database dependency (pre-created via CLI).

2. Deploy the Current App

adios up

The deploy uploads your current source, builds the app, creates a runtime version, starts replicas, and promotes the current release when the deployment is healthy.

3. Inspect Logs

adios logs --build
adios logs --runtime

Use build logs to debug package installs and compile output. Use runtime logs to debug the live app.

4. Continue in a Workspace

After an app has source attached, open it in the Web IDE to inspect and edit the same code that produced the deployed runtime. From there you can ask the AI agent to add features, edit APIs, create workflows, run previews, commit to Git, or sync files back to your local repo.

adios sync
adios sync --pull

adios sync pushes local files into a linked workspace. adios sync --pull copies workspace files back down to your local directory.