> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marina.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Install Marina and deploy your first app.

## Before you begin

Install Node.js 22 or later. You also need access to a Marina workspace.

<Steps>
  <Step title="Install the CLI">
    ```bash theme={null}
    npm install -g @marina-cloud/cli
    ```
  </Step>

  <Step title="Sign in">
    ```bash theme={null}
    marina setup
    ```

    Marina opens your browser for sign-in and delivers the resulting credential
    back to the CLI. The credential is stored with user-only permissions in
    `~/.marina/profile`.
  </Step>

  <Step title="Deploy a project">
    Run this from the project directory:

    ```bash theme={null}
    marina deploy
    ```

    Marina uploads the project, follows its build, and prints the live URL when
    the version has been published.
  </Step>
</Steps>

## Try the demo

To verify your account without preparing a project first, deploy the bundled
Hello Marina collage:

```bash theme={null}
marina deploy demo
```

The demo is a real Marina app. You can open it, redeploy it, inspect its
versions, and delete it from the dashboard when you are finished.

## Deploy with a coding agent

Ask the agent to install Marina's deployment skill explicitly:

```bash theme={null}
marina skills install
```

For orchestration, add `--json` to every command:

```bash theme={null}
marina deploy --json
```

Machine-readable results are written to standard output. Human progress stays
on standard error.

<Card title="Configure the project" icon="file-json" href="/guides/app-configuration">
  Add `marina.json` when you want an explicit name, icon, or runtime.
</Card>