.

node_modules/next/dist/docs/01-app/01-getting-started/18-upgrading.md

@@ -0,0 +1,87 @@
+---
+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)