---
title: Documentation
url: "/docs/"
canonical_url: https://docs.blossom88.com/docs/
markdown_url: https://docs.blossom88.com/docs.md
summary: Blossom deploys your Apps and keeps them running, on Blossom Cloud or your
  own cloud account.
---

# Documentation

Use Blossom Cloud or connect your own cloud provider account. Both use the same
Apps, Environments, Services, Data, and operational evidence.

## [Getting Started](/learn/getting-started/)

- [Deploy from Chat](/docs/ai-agents/first-blossom-chat/) — Ask Blossom to preview and deploy a FastAPI example in your AI app.
- [Deploy with the CLI](/learn/prompt-and-deploy/) — Deploy your repository from a terminal, on your own or with a coding agent.
- [Deploy in the Web UI](/learn/getting-started/web-ui/) — Review the FastAPI example in your browser and watch it go live.



## Operate the product

<div class="docs-card-grid not-typography">
  <a href="/docs/apps/" class="docs-card">
    <h3>Apps</h3>
    <p>Environments, Services, Builds, Releases, health, and configuration.</p>
  </a>
  <a href="/docs/apps/preview-environments/" class="docs-card">
    <h3>Preview Environments</h3>
    <p>A temporary copy for each pull request or branch.</p>
  </a>
  <a href="/docs/apps/environment-access/" class="docs-card">
    <h3>Environment Access</h3>
    <p>Account members, shareable links, bypass tokens, or a password.</p>
  </a>
  <a href="/docs/data/" class="docs-card">
    <h3>Data</h3>
    <p>Databases, Caches, backups, and recovery.</p>
  </a>
  <a href="/docs/domains/" class="docs-card">
    <h3>Domains</h3>
    <p>Generated endpoints, custom names, routing, and TLS.</p>
  </a>
  <a href="/docs/monitoring/" class="docs-card">
    <h3>Observe</h3>
    <p>Logs, metrics, Containers, health, and Activity.</p>
  </a>
  <a href="/docs/capacity/" class="docs-card">
    <h3>Capacity</h3>
    <p>Sizing, the capacity limit, and what Blossom charges for.</p>
  </a>
  <a href="/docs/debug/" class="docs-card">
    <h3>Troubleshooting</h3>
    <p>Start from Product health, logs, and Activity.</p>
  </a>
</div>

## Choose where Apps run

Every App runs in one [Location](/docs/locations/): a Blossom
Cloud region, or a region in your own cloud account.
[Cloud Providers](/docs/locations/cloud-providers/) explains Blossom Cloud and
Blossom BYOC (bring your own cloud), including setup, billing, credentials,
permissions, and quota.

## Reference

Use the [Blossom CLI concepts](/docs/blossom-cli/) for profiles
and defaults and the [CLI Reference](/docs/reference/cli/) for exact command
syntax.