# Quickstart

> Install the CLI, authenticate, and ship your first service in minutes.

Yalla deploys and operates services through **Yalla Runtime** and the **Yalla Deploy Engine**. This quickstart takes you from an empty machine to a running service. Agents can follow the same steps from the [CLI reference](/docs/cli).

## Install the CLI

Install globally.

```bash
npm install -g @yalla/cli
```

Verify the install.

```bash
yalla --version
```

## Authenticate

Sign in with a browser-based flow. The CLI stores a short-lived session token in your OS keychain — never in plaintext, and never in this documentation.

```bash
yalla login
```

## Ship your first service

From a project directory with a `yalla.toml` manifest, deploy to an environment. See the [manifest schema](/docs/manifest-schema) for every field.

```bash
yalla deploy --env staging
```

> [!NOTE]
> Deployments are asynchronous. Watch progress with `yalla jobs watch` or in the control plane.