# Prisma Compute (/docs/compute)

> For the complete Prisma documentation index, see [llms.txt](/llms.txt). A markdown version of any docs page is available by appending `.md` to its URL.

Deploy TypeScript services alongside Prisma Postgres, with hosting, database branches, and previews managed together.

Location: Prisma Compute

Prisma Compute is a hosting platform for TypeScript services. It runs your application next to [Prisma Postgres](/guides/introduction-2-postgres) and gives every Git branch an isolated environment: its own service, environment variables, and optionally its own database.

Compute works with any supported TypeScript framework. It pairs with [Prisma ORM](/guides/introduction-2-orm) for data access, but that is not required.

> \[!NOTE]
> These docs use the Prisma CLI, run as `npx prisma@latest`. Deployments come from the [`deploy` command](/guides/platform-deploy) for a [Prisma Composer](/guides/build-composer) app, from a git push once you [set up deploy on push](/guides/integrations-deploy-on-push), or from the [Console](https://pris.ly/pdp). See [Deployments](/guides/features-2-compute-deployments) for details.

## Get started

- [Deploy your first service](/guides/introduction-5-compute-getting-started): Sign in, deploy a Composer app, and set up deploys on push.

- [Deploy quickstart](/guides/start-prisma-compute-deploy): The short path: declare a new app or bring one you have, then deploy it with Composer.

Declare your app with [Prisma Composer](/guides/build-composer), whether it has one service or several: you describe each service and the databases it depends on in TypeScript, and one deploy provisions them together.

## The model

Compute organizes everything into a few resources:

- A **project** groups one product or codebase.
- A **branch** maps to a Git branch in the linked repository. Each branch is an isolated environment with its own services, environment variables, and deployments, and can have its own database.
- A **service** is an HTTP application, such as a frontend or backend. Each deploy of a service creates a **version**. One version is live at a time.

The default Git branch (usually `main`) is the **production** branch. Every other branch is a **preview** branch with its own Compute resources: services, deployments, and environment variables. Data isolation is yours to configure. A preview deploy reads the preview-scoped variables. If preview work must not touch production data, point the preview `DATABASE_URL` at a non-production database. See [Environment variables](/guides/features-2-compute-environment-variables) for details. After you [set up deploy on push](/guides/integrations-deploy-on-push), pushing to a branch deploys that branch from your repository's GitHub Actions.

The animation below shows how a project, its branches, and their infrastructure fit together, and how each branch's variables resolve by scope:

For the full picture, see [Branching](/guides/features-2-compute-branching).

## CLI and Console

Use the **CLI** for anything you want to repeat: local development, CI, and agent workflows. Every command supports a `--json` flag that switches its output to machine-readable JSON, so scripts and agents can parse results instead of scraping terminal text.

Use the \*\*[Console](https://pris.ly/pdp)\*\* to view and manage projects, branches, services, and deployments in a browser instead of running commands.

## What to read next

Once you have deployed something, read [Deployments](/guides/features-2-compute-deployments) for logs, promoting, and rolling back, and [Environment variables](/guides/features-2-compute-environment-variables) for configuration per scope. [Object storage](/guides/features-2-compute-object-storage) covers S3-compatible Object Store buckets, next to your databases in the same project. The [CLI reference](/guides/reference-3-cli) documents every command and flag. For what Compute can and can't do, read the [known limitations](/guides/more-3-compute-limitations).

## Related pages

- [`Choose a Prisma ORM setup path`](/guides/start-getting-started): Choose the fastest path to try Prisma ORM in a new or existing project.
- [`Console`](/guides/manage-console): Learn how to use the Console to manage and integrate Prisma products into your application.
- [`Deploy the full Prisma stack`](/guides/start-full-stack-tutorial): A single tutorial from empty directory to live URL, with Prisma Composer, Prisma ORM, and Prisma Postgres.
- [`Introduction to Prisma ORM`](/guides/prisma-orm-prisma-orm): Prisma ORM 8 is the current release.
- [`Local development`](/guides/build-local-development): Run the whole Prisma stack on your machine, with your app on Bun, a local Prisma Postgres database, and local object storage.

## Related pages

- [Authentication & Tools](./authentication-tools-index.md)
- [Build](./build-index.md)
- [Changelog](../changelog.md)
- [Concepts](./concepts-index.md)
- [Console commands](./console-commands-index.md)
- [Contract Authoring](./contract-authoring-index.md)
- [Core Concepts](./core-concepts-index.md)
- [Data Modeling](./data-modeling-index.md)
- [Database](./database-index.md)
- [DB commands](./db-commands-index.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.
