Prisma Compute (/docs/compute)
For the complete Prisma documentation index, see llms.txt. A markdown version of any docs page is available by appending
.mdto 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 thedeploycommand for a Prisma Composer app, from a git push once you set up deploy on push, or from the Console. See Deployments for details.
Get started
Section titled “Get started”-
Deploy your first service: Sign in, deploy a Composer app, and set up deploys on push.
-
Deploy quickstart: The short path: declare a new app or bring one you have, then deploy it with Composer.
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.
The model
Section titled “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 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.
CLI and Console
Section titled “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** to view and manage projects, branches, services, and deployments in a browser instead of running commands.
What to read next
Section titled “What to read next”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.
Related pages
Section titled “Related pages”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.