Some checks failed
Test examples / Test Examples (20) (push) Has been cancelled
Test examples / Test Examples (22) (push) Has been cancelled
Lock Threads / action (push) Has been cancelled
Trigger Release / start (push) Has been cancelled
Stale issue handler / stale (push) Has been cancelled
Update Font Data / create-pull-request (push) Has been cancelled
build-and-deploy / deploy-target (push) Has been cancelled
build-and-deploy / build (push) Has been cancelled
build-and-deploy / stable - aarch64-unknown-linux-musl - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-unknown-linux-musl - node@16 (push) Has been cancelled
build-and-deploy / stable - aarch64-unknown-linux-gnu - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-unknown-linux-gnu - node@16 (push) Has been cancelled
build-and-deploy / stable - aarch64-pc-windows-msvc - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-pc-windows-msvc - node@16 (push) Has been cancelled
build-and-deploy / stable - aarch64-apple-darwin - node@16 (push) Has been cancelled
build-and-deploy / stable - x86_64-apple-darwin - node@16 (push) Has been cancelled
build-and-deploy / build-wasm (nodejs) (push) Has been cancelled
build-and-deploy / build-wasm (web) (push) Has been cancelled
build-and-deploy / Deploy preview tarball (push) Has been cancelled
build-and-deploy / Potentially publish release (push) Has been cancelled
build-and-deploy / publish-turbopack-npm-packages (push) Has been cancelled
build-and-deploy / Deploy examples (push) Has been cancelled
build-and-deploy / thank you, build (push) Has been cancelled
build-and-deploy / Upload Turbopack Bytesize metrics to Datadog (push) Has been cancelled
Rspack Next.js development integration tests / Rspack integration tests (push) Has been cancelled
Rspack Next.js production integration tests / Rspack integration tests (push) Has been cancelled
Turbopack Next.js development integration tests / Next.js integration tests (push) Has been cancelled
Turbopack Next.js production integration tests / Next.js integration tests (push) Has been cancelled
Update Rspack test manifest / Update and upload Rspack development test manifest (push) Has been cancelled
Update Rspack test manifest / Update and upload Rspack production test manifest (push) Has been cancelled
Upload bundler test manifests to areweturboyet.com / Upload test results (push) Has been cancelled
Update React / create-pull-request (push) Has been cancelled
test-e2e-project-reset-cron / reset-test-project (push) Has been cancelled
Notify about the top 15 issues/PRs/feature requests (most reacted) in the last 90 days / run (push) Has been cancelled
88 lines
2.1 KiB
Plaintext
88 lines
2.1 KiB
Plaintext
---
|
|
title: Upgrading
|
|
description: Learn how to upgrade your Next.js application to the latest version or canary.
|
|
related:
|
|
title: Version guides
|
|
description: See the version guides for in-depth upgrade instructions.
|
|
links:
|
|
- app/guides/upgrading/version-16
|
|
- app/guides/upgrading/version-15
|
|
- app/guides/upgrading/version-14
|
|
---
|
|
|
|
## Latest version
|
|
|
|
To update to the latest version of Next.js, you can use the `upgrade` command:
|
|
|
|
```bash package="pnpm"
|
|
pnpm next upgrade
|
|
```
|
|
|
|
```bash package="npm"
|
|
npx next upgrade
|
|
```
|
|
|
|
```bash package="yarn"
|
|
yarn next upgrade
|
|
```
|
|
|
|
```bash package="bun"
|
|
bunx next upgrade
|
|
```
|
|
|
|
Versions before Next.js 16.1.0 do not support the `upgrade` command and need to use a separate package instead:
|
|
|
|
```bash filename="Terminal"
|
|
npx @next/codemod@canary upgrade latest
|
|
```
|
|
|
|
If you prefer to upgrade manually, install the latest Next.js and React versions:
|
|
|
|
```bash package="pnpm"
|
|
pnpm i next@latest react@latest react-dom@latest eslint-config-next@latest
|
|
```
|
|
|
|
```bash package="npm"
|
|
npm i next@latest react@latest react-dom@latest eslint-config-next@latest
|
|
```
|
|
|
|
```bash package="yarn"
|
|
yarn add next@latest react@latest react-dom@latest eslint-config-next@latest
|
|
```
|
|
|
|
```bash package="bun"
|
|
bun add next@latest react@latest react-dom@latest eslint-config-next@latest
|
|
```
|
|
|
|
## Canary version
|
|
|
|
To update to the latest canary, make sure you're on the latest version of Next.js and everything is working as expected. Then, run the following command:
|
|
|
|
```bash package="pnpm"
|
|
pnpm add next@canary
|
|
```
|
|
|
|
```bash package="npm"
|
|
npm i next@canary
|
|
```
|
|
|
|
```bash package="yarn"
|
|
yarn add next@canary
|
|
```
|
|
|
|
```bash package="bun"
|
|
bun add next@canary
|
|
```
|
|
|
|
### Features available in canary
|
|
|
|
The following features are currently available in canary:
|
|
|
|
**Authentication**:
|
|
|
|
- [`forbidden`](/docs/app/api-reference/functions/forbidden)
|
|
- [`unauthorized`](/docs/app/api-reference/functions/unauthorized)
|
|
- [`forbidden.js`](/docs/app/api-reference/file-conventions/forbidden)
|
|
- [`unauthorized.js`](/docs/app/api-reference/file-conventions/unauthorized)
|
|
- [`authInterrupts`](/docs/app/api-reference/config/next-config-js/authInterrupts)
|