Skip to main content
Prisma Documentation Docs

Search documentation

Type to search this documentation.

On this pageOverview

Prisma Compute (/docs/compute)

For the complete Prisma documentation index, see 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 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 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 for a Prisma Composer app, from a git push once you set up deploy on push, or from the Console. See Deployments for details.

Declare your app with Prisma 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.

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 for details. After you set up 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.

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** to view and manage projects, branches, services, and deployments in a browser instead of running commands.

Once you have deployed something, read Deployments for logs, promoting, and rolling back, and Environment variables for configuration per scope. Object storage covers S3-compatible Object Store buckets, next to your databases in the same project. The CLI reference documents every command and flag. For what Compute can and can't do, read the known limitations.

  • Choose a Prisma ORM setup path: Choose the fastest path to try Prisma ORM in a new or existing project.
  • Console: Learn how to use the Console to manage and integrate Prisma products into your application.
  • Deploy the full Prisma stack: A single tutorial from empty directory to live URL, with Prisma Composer, Prisma ORM, and Prisma Postgres.
  • Introduction to Prisma ORM: Prisma ORM 8 is the current release.
  • Local development: Run the whole Prisma stack on your machine, with your app on Bun, a local Prisma Postgres database, and local object storage.
Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu