# Upgrade to Prisma 8 (/docs/guides/upgrade-prisma-orm)

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

Use when choosing how to upgrade an app from Prisma ORM 6 or 7 to Prisma 8: pick the guide for your database, your current version, and whether to move in one pass or route by route

Location: Guides > Upgrade to Prisma 8

Prisma 8 is a [release candidate](https://www.prisma.io/docs/orm/release-status). Each guide below keeps your database and its data, and ends with the app running only on Prisma 8. Pick the one that matches your database, the version you run today, and how you want to move:

| Database        | You run           | Strategy                                                                                | Guide                                                                                               |
| --------------- | ----------------- | --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| PostgreSQL      | Prisma ORM 6 or 7 | All at once: keep your `schema.prisma` and rewrite every query in one pass              | [Prisma ORM 6 or 7 to 8 (PostgreSQL)](https://www.prisma.io/docs/guides/upgrade-prisma-orm/postgresql)                        |
| PostgreSQL      | Prisma ORM 7      | Route by route: run Prisma ORM 7 and Prisma 8 side by side and move one route at a time | [Prisma ORM 7 to 8, route by route (PostgreSQL)](https://www.prisma.io/docs/guides/upgrade-prisma-orm/postgresql-incremental) |
| MongoDB         | Prisma ORM 6      | All at once (Prisma ORM 7 has no MongoDB connector)                                     | [Prisma ORM 6 to 8 (MongoDB)](https://www.prisma.io/docs/guides/upgrade-prisma-orm/mongodb)                                   |
| Any but MongoDB | Prisma ORM 6      | Staying on Prisma ORM 7 for now                                                         | [Upgrade to Prisma ORM 7](https://www.prisma.io/docs/guides/upgrade-prisma-orm/v7)                                            |

On Prisma ORM 5 or earlier, upgrade one major version at a time first, because each release has breaking changes of its own: [to 6](https://www.prisma.io/docs/guides/upgrade-prisma-orm/v6), [to 5](https://www.prisma.io/docs/guides/upgrade-prisma-orm/v5), [to 4](https://www.prisma.io/docs/guides/upgrade-prisma-orm/v4), [to 3](https://www.prisma.io/docs/guides/upgrade-prisma-orm/v3), or [from Prisma 1](https://www.prisma.io/docs/guides/upgrade-prisma-orm/v1).

The two PostgreSQL guides also differ in where the [contract](https://www.prisma.io/docs/orm/contract-authoring/the-data-contract) comes from. The all-at-once guide reads your existing `schema.prisma` through `prisma7Schema(...)`, so you keep editing that file. The route-by-route guide infers a new `contract.prisma` from the live database.

## Deploying on Prisma Compute [#deploying-on-prisma-compute]

Prisma Compute runs only Prisma 8, so finish the upgrade before you deploy there. An app in the middle of the route-by-route guide still runs Prisma ORM 7 and cannot deploy on Compute until that guide's last step removes it.

[Deploy an existing app on Prisma Compute](https://www.prisma.io/docs/guides/compute/deploy-existing-app) covers PostgreSQL apps, which get a Prisma Postgres database for each branch. Today it needs the Prisma 8 versions the all-at-once guide installs. The route-by-route guide installs the latest Prisma 8 releases, which Compute does not deploy yet, so check the deploy guide's [prerequisites](https://www.prisma.io/docs/guides/compute/deploy-existing-app#prerequisites) before you start.

## Related pages

- [`Guides`](https://www.prisma.io/docs/guides/v7): A collection of guides for various tasks and workflows
- [`Writing guides`](https://www.prisma.io/docs/guides/making-guides): How to write, validate, and file a Prisma ORM guide for the Prisma documentation.