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

# Quickstart

> Set up your Octavia workspace and go live in minutes.

> Deploy your first Octavia service in minutes

This quickstart walks you through creating an account, activating a service (like **AI CMS**), and generating an API key.
By the end, you’ll have a live workspace, a selected service/plan, and credentials to start building.

<Info>
  <strong>Prerequisites</strong>: You’ll need an Octavia account. If you don’t
  have one yet,{" "}
  <a href="https://auth.octaviatech.app/core/register">create a free account</a>
  .
</Info>

## Getting started

Follow the steps below. Each step can include a screenshot — feel free to replace the image placeholders with your own.

### 1) Visit the site and click <em>Sign in</em>

<Frame>
  <img src="https://mintcdn.com/octavia/RRgC7KA_9dpSBjlF/images/quickstart/step-1.png?fit=max&auto=format&n=RRgC7KA_9dpSBjlF&q=85&s=396c59545d554dde99524f41e500fd70" alt="Landing page with Sign in button" width="1471" height="822" data-path="images/quickstart/step-1.png" />
</Frame>

Go to **octaviatech.app** and click **Login**.

***

### 2) Sign in or create an account

If you already have an account, sign in.
Otherwise, click **Create account** and enter **First name, Last name, Email, Password,** and **Region**, then complete registration.

<Frame>
  <img src="https://mintcdn.com/octavia/RRgC7KA_9dpSBjlF/images/quickstart/step-2.png?fit=max&auto=format&n=RRgC7KA_9dpSBjlF&q=85&s=c5653de72f164cc895a545c0f09c4a78" alt="Registration form" width="1468" height="822" data-path="images/quickstart/step-2.png" />
</Frame>

***

### 3) Enter the dashboard and select a team

After sign-in, you’ll land in the **Dashboard**. Your **first team** is created automatically using your name.
You can create additional teams later, but to begin quickly, **select the default team** to continue.

<Frame>
  <img src="https://mintcdn.com/octavia/RRgC7KA_9dpSBjlF/images/quickstart/step-3.png?fit=max&auto=format&n=RRgC7KA_9dpSBjlF&q=85&s=66a0de017bbb44f29fe0bb1980ed97b5" alt="Dashboard with default team selection" width="1467" height="830" data-path="images/quickstart/step-3.png" />
</Frame>

***

### 4) Open the Octavia Services catalog

From the dashboard, open **Octavia Services** and pick the product you want (e.g., **AI CMS**, **Auth**, **Payments**, etc.).

<Frame>
  <img src="https://mintcdn.com/octavia/RRgC7KA_9dpSBjlF/images/quickstart/step-4.png?fit=max&auto=format&n=RRgC7KA_9dpSBjlF&q=85&s=6f3a9fd939053ae77de8e94278791296" alt="Service catalog" width="1471" height="827" data-path="images/quickstart/step-4.png" />
</Frame>

Select your service

<Frame>
  <img src="https://mintcdn.com/octavia/RRgC7KA_9dpSBjlF/images/quickstart/step-4.2.png?fit=max&auto=format&n=RRgC7KA_9dpSBjlF&q=85&s=d1cdebbb919e6d98eca085ee32d3098b" alt="Service catalog" width="1466" height="822" data-path="images/quickstart/step-4.2.png" />
</Frame>

***

### 5) Choose a plan

Pick a plan that matches your team’s needs. You can start on the **Free** plan and upgrade any time.

<Frame>
  <img src="https://mintcdn.com/octavia/RRgC7KA_9dpSBjlF/images/quickstart/step-5.png?fit=max&auto=format&n=RRgC7KA_9dpSBjlF&q=85&s=8e2c7e48fcb8e506587927fd9753ec62" alt="Plan selection screen" width="1470" height="823" data-path="images/quickstart/step-5.png" />
</Frame>

During setup, you can claim a free, hosted subdomain in this format:

```
https://<your-domain>.octaviatech.app
```

***

### 6) Provision complete → Configure and build

<Frame>
  <img src="https://mintcdn.com/octavia/RRgC7KA_9dpSBjlF/images/quickstart/step-6.1.png?fit=max&auto=format&n=RRgC7KA_9dpSBjlF&q=85&s=c251f8e6dda4a4d5a8917fa02423ccec" alt="Service dashboard and settings" width="1469" height="830" data-path="images/quickstart/step-6.1.png" />
</Frame>

Once the service is created (and billing completed if applicable), you can:

* View **service settings**
* Open the **product console**
* Create **API keys**
* Manage everything from the **left navigation**

<Frame>
  <img src="https://mintcdn.com/octavia/RRgC7KA_9dpSBjlF/images/quickstart/step-6.2.png?fit=max&auto=format&n=RRgC7KA_9dpSBjlF&q=85&s=fe55aed1016b082cef9c6141ea9a0ae2" alt="Service dashboard and settings" width="1471" height="827" data-path="images/quickstart/step-6.2.png" />
</Frame>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="I can’t see my default team">
    Refresh the dashboard or re-open the team switcher. If the default team was renamed or removed, create a new one and select it before continuing.
  </Accordion>

  {" "}

  <Accordion title="Service not visible after selecting a plan">
    Check your billing status if you chose a paid plan. If payment succeeded,
    refresh the dashboard; provisioning usually completes within seconds.
  </Accordion>

  {" "}

  <Accordion title="Requests are failing with 401">
    Ensure the <code>x-api-key</code> header is present on every request and that
    you’re using a valid, active key from the dashboard.
  </Accordion>

  <Accordion title="Hitting rate limits (429)">
    The limit is 50 req/s per IP. Implement client-side queuing and exponential backoff, or distribute requests across workers.
  </Accordion>
</AccordionGroup>
