ory · wassimoo · Apr 23, 2026 · Dec 16, 2025 · Dec 16, 2025 · Dec 16, 2025
@@ -0,0 +1,5 @@
+reviews:
+  review_status: false
+  # Temporarily exclude MDX files from review processing.
+  path_filters:
+    - "!**/*.mdx"
@@ -19,10 +19,10 @@ jobs:
     runs-on: ubuntu-latest
     name: Find closed references
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-node@v2-beta
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
-          node-version: "14"
+          node-version: "24"
       - uses: ory/closed-reference-notifier@v1
         with:
           token: ${{ secrets.GITHUB_TOKEN }}

@@ -24,7 +24,7 @@ jobs:
     name: Validate PR title
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v6
       - id: config
         uses: ory/ci/conventional_commit_config@master
         with:

@@ -16,7 +16,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v6
       - name: Synchronize Issue Labels
         uses: ory/label-sync-action@v0
         with:

@@ -1,6 +1,6 @@
 :::info Professional support?
 
 Ory offers support for self-hosted Ory software through the Ory Enterprise License (OEL). Read more about the OEL
-[here](https://www.ory.com/docs/self-hosted/oel).
+[here](../oel/getting-started/index.mdx).
 
 :::
@@ -4,7 +4,7 @@ title: API Design
 ---
 
 This document provides a summary of Ory's REST design with topics like pagination and date formats. If you're interested in Ory's
-API design, check out the [REST API design guidelines](../open-source/guidelines/rest-api-guidelines.md).
+API design, check out the [REST API design guidelines](../oss/guidelines/rest-api-guidelines.md)
 
 ## Date format
 

@@ -2,6 +2,7 @@
 id: go
 title: Integrate authentication into Go
 sidebar_label: Go
+displayed_sidebar: quickstartsSidebar
 ---
 
 ```mdx-code-block

@@ -2,6 +2,7 @@
 id: php
 title: Integrate authentication into PHP
 sidebar_label: PHP
+displayed_sidebar: quickstartsSidebar
 ---
 
 ```mdx-code-block

@@ -2,6 +2,7 @@
 id: expressjs
 title: Integrate authentication into Node.js / Express.js
 sidebar_label: Node.js / Express.js
+displayed_sidebar: quickstartsSidebar
 ---
 
 ```mdx-code-block

@@ -2,6 +2,7 @@
 id: auth-js
 title: Integrate authentication into Auth.js and NextAuth
 sidebar_label: Auth.js / NextAuth
+displayed_sidebar: quickstartsSidebar
 ---
 
 # Integrate authentication into Auth.js and NextAuth

@@ -2,6 +2,7 @@
 id: nextjs-app-router-quickstart
 title: Next.js App Router Quickstart
 sidebar_label: Next.js (App Router)
+displayed_sidebar: quickstartsSidebar
 ---
 
 import Tabs from "@theme/Tabs"

@@ -2,6 +2,7 @@
 id: nextjs-pages-router-quickstart
 title: Next.js Pages Router Quickstart
 sidebar_label: Next.js (Pages Router)
+displayed_sidebar: quickstartsSidebar
 ---
 
 import Tabs from "@theme/Tabs"

@@ -2,6 +2,7 @@
 id: flutter-web-redirect
 title: Integrate authentication into Flutter Web
 sidebar_label: Flutter
+displayed_sidebar: quickstartsSidebar
 ---
 
 ```mdx-code-block

@@ -2,6 +2,7 @@
 id: react
 title: Integrate authentication into React + API
 sidebar_label: React
+displayed_sidebar: quickstartsSidebar
 ---
 
 ```mdx-code-block

@@ -2,6 +2,7 @@
 id: vue
 title: Integrate authentication into Vue.js + API
 sidebar_label: Vue.js
+displayed_sidebar: quickstartsSidebar
 ---
 
 ```mdx-code-block

@@ -2,6 +2,7 @@
 id: react-native
 title: Integrate Authentication into React Native
 sidebar_label: React Native
+displayed_sidebar: quickstartsSidebar
 ---
 
 import CodeFromRemote from "@theme/CodeFromRemote"

@@ -2,6 +2,7 @@
 id: java
 title: Integrate authentication into Java + Spring Boot
 sidebar_label: Java (Spring Boot)
+displayed_sidebar: quickstartsSidebar
 ---
 
 ```mdx-code-block

@@ -2,6 +2,7 @@
 id: dotnet
 title: Integrate authentication into ASP.NET
 sidebar_label: .NET / ASP.NET
+displayed_sidebar: quickstartsSidebar
 ---
 
 ```mdx-code-block

@@ -1,7 +1,7 @@
 ---
 id: ory-network-oauth2
-title: Perform OAuth2 Authorization Code Grant and Client Credentials Grant
-sidebar_label: Try it
+title: OAuth2 authorization code and client credentials grants
+sidebar_label: OAuth2 grants
 ---
 
 # Try common OAuth2 Grants

@@ -1,15 +1,18 @@
 ---
 id: overview
-title: Quickstarts & Tutorials
+title: Quickstarts
+displayed_sidebar: quickstartsSidebar
+hide_title: true
 ---
 
-Are you looking for an example to just get started? Check out all available examples!
+import { QuickstartsOverviewHeading } from "@site/src/components/QuickStarts/QuickstartsOverviewHeading"
+
+<QuickstartsOverviewHeading />
+
+Get started with Ory using the guides and examples that best match your use case.
 
 ```mdx-code-block
-import ExampleList from "@site/src/components/Examples/example-list"
-import * as content from "@site/src/pages/_assets/examples-content"
+import { QuickstartFilter } from "@site/src/components/QuickStarts/quickstart-filter"
 
-<ExampleList {...content.basic} />
-<ExampleList {...content.customui} />
-<ExampleList {...content.community} />
+<QuickstartFilter />
 ```
@@ -8,5 +8,5 @@ title: OAuth2 and OpenID Connect
 import DocCardList from '@theme/DocCardList';
 import {useCurrentSidebarCategory} from '@docusaurus/theme-common';
 
-<DocCardList items={useCurrentSidebarCategory().items}/>
+<DocCardList items={useCurrentSidebarCategory().items} />
 ```
@@ -1,6 +1,6 @@
 ---
 id: operations
-title: Operations
+title: Console
 ---
 
 ```mdx-code-block

@@ -1,6 +1,6 @@
 ---
 id: configuration
-title: Configuration
+title: Configure Ory Hydra
 ---
 
 ```mdx-code-block

@@ -48,7 +48,7 @@ DSN=sqlite:///path/to/hydra.sqlite?_fk=true
 The `_fk=true` parameter is required for SQLite to enable foreign key constraints.
 
 For additional DSN options including SSL/TLS configuration, see
-[Deployment Fundamentals and Requirements](../../self-hosted/deployment).
+[Deployment Fundamentals and Requirements](../../oss/deployment.mdx).
 
 ## Running migrations
 

@@ -8,8 +8,8 @@ import CodeBlock from "@theme/CodeBlock"
 
 This guide explains how to set up and run Ory Hydra in an exemplary production environment. It uses Postgres as database, Nginx as
 reverse proxy, and Digital Ocean as cloud provider. You can use another
-[relational database](../../self-hosted/deployment#data-storage-and-persistence), a different reverse proxy, deploy on any other
-cloud host, and [spin up a custom user interface in your favorite language](../sdk/overview) - this is just an example!
+[relational database](../../oss/deployment.mdx#data-storage-and-persistence), a different reverse proxy, deploy on any other cloud
+host, and [spin up a custom user interface in your favorite language](../sdk/overview) - this is just an example!
 
 ## Create a Droplet
 
@@ -477,4 +477,4 @@ server {
 - Read the [Prepare for production](./production).
 - Fork the [Ory Hydra Node.js UI Reference](https://github.com/ory/hydra-login-consent-node) or
   [build a custom UI in the language of your choice](../sdk/01_overview.md).
-- [Add Identity and Account Management](../../identities/index.mdx)
+- [Add Identity and Account Management](../../oel/kratos/intro.mdx)
@@ -7,7 +7,7 @@ Read this document to prepare for production when self-hosting Ory Hydra.
 Feel free to [open an issue or pull request](https://github.com/ory/docs/) when you have an idea how to improve this
 documentation.
 
-Read more about [deployment fundamentals and requirements for Ory](../../self-hosted/deployment).
+Read more about [deployment fundamentals and requirements for Ory](../../oss/deployment.mdx).
 
 ## Security checklist
 

@@ -6,7 +6,7 @@ sidebar_label: Introduction
 
 Ory Kratos Identities is an API-first identity and user management system built on top of the widely deployed open-source
 [Ory Kratos](https://github.com/ory/kratos) following
-[cloud architecture best practices](ecosystem/software-architecture-philosophy.mdx). It implements mechanisms that allow handling
+[cloud architecture best practices](../oss/software-architecture-philosophy.mdx). It implements mechanisms that allow handling
 core use cases that the majority of modern software applications have to deal with:
 
 - **Self-service login and registration**: Allow end-users to create and sign in to accounts using username/email and password

@@ -125,4 +125,4 @@ Ory is the largest open-source ecosystem in the area of authentication, authoriz
 in the world. Ory is not another company "greenwashing" with open source by publishing SDKs under open-source licenses. Instead,
 all Ory core systems are available as Apache 2.0 licensed software without enterprise or open-core models.
 
-Head over to the [Ory Open Source Overview](./open-source.mdx) for an introduction to the different projects.
+Head over to the [Ory Open Source Overview](./oss/open-source.mdx) for an introduction to the different projects.
@@ -1,5 +1,7 @@
 ---
-title: "Basic: Olymp library"
+id: file-sharing-example
+title: "File sharing example"
+sidebar_label: File sharing example
 ---
 
 ## A basic, down-to-earth full feature example

@@ -7,12 +7,12 @@ Read this document to prepare for production when self-hosting Ory Keto.
 Feel free to [open an issue or pull request](https://github.com/ory/docs/) when you have an idea how to improve this
 documentation.
 
-Read more about [deployment fundamentals and requirements for Ory](../../self-hosted/deployment).
+Read more about [deployment fundamentals and requirements for Ory](../../oss/deployment.mdx).
 
 ## Database
 
 Ory Keto requires a production-grade database such as PostgreSQL, MySQL, CockroachDB. Don't use SQLite in production! Read more
-about [deployment fundamentals and requirements for Ory](../../self-hosted/deployment).
+about [deployment fundamentals and requirements for Ory](../../oss/deployment.mdx).
 
 ## Security checklist
 

@@ -20,4 +20,4 @@ described in the following section.
 Environmental variables take precedence over config file values. Nested paths get mapped to config values by putting an underscore
 `_` between every level, so `selfservice.flows.settings.ui_url` becomes `SELFSERVICE_FLOWS_SETTINGS_UI_URL=<value>`.
 
-Please note that there are some caveats when using env vars [documented here](../ecosystem/configuring).
+Please note that there are some caveats when using env vars [documented here](../oss/configuring.mdx).
@@ -9,8 +9,8 @@ import CodeBlock from "@theme/CodeBlock"
 This guide explains how to set up and run Ory Kratos in an exemplary production environment. It uses Postgres as database, Nginx
 as reverse proxy, Digital Ocean as cloud provider, and the
 [Ory Kratos Node.js UI Reference](https://github.com/ory/kratos-selfservice-ui-node) as user interface. You can use another
-[relational database](../../self-hosted/deployment#data-storage-and-persistence), a different reverse proxy, deploy on any other
-cloud host, and [spin up a custom interface in your favorite language](../sdk/overview) - this is just an example!
+[relational database](../../oss/deployment.mdx#data-storage-and-persistence), a different reverse proxy, deploy on any other cloud
+host, and [spin up a custom interface in your favorite language](../sdk/overview) - this is just an example!
 
 ## Create a Droplet
 

@@ -7,7 +7,7 @@ Read this document to prepare for production when self-hosting Ory Kratos.
 Feel free to [open an issue or pull request](https://github.com/ory/docs/) when you have an idea how to improve this
 documentation.
 
-Read more about [deployment fundamentals and requirements for Ory](../../self-hosted/deployment).
+Read more about [deployment fundamentals and requirements for Ory](../../oss/deployment.mdx).
 
 ## Database
 

@@ -755,7 +755,7 @@ automatically link the email address with the social sign-in provider. However,
 process.
 
 For more details, refer to the
-[automatic account linking documentation](../social-signin/95_account-linking.mdx#automatic-account-linking).
+[automatic account linking documentation](../self-service/flows/account-recovery-password-reset.mdx).
 
 ### SAML connections
 

@@ -25,7 +25,7 @@ Ory's self-service flows support passwordless authentication for browser-based a
 After enabling it in Ory, the Ory Account Experience automatically presents passwordless as an option in the registration and
 login flows. When developing your own authentication UI for a browser-based app, the steps for integrating your application with
 the passwordless registration and login flows are described
-[in the documentation](../bring-your-own-ui/custom-ui-advanced-integration).
+[in the documentation](../bring-your-own-ui/10_custom-ui-advanced-integration.mdx).
 
 There are two different classes of authenticators that can be used with passwordless:
 

@@ -5,8 +5,10 @@ sidebar_label: Passkeys for mobile
 slug: passkeys-mobile-web-implementation
 ---
 
+```mdx-code-block
 import Tabs from "@theme/Tabs"
 import TabItem from "@theme/TabItem"
+```
 
 This guide covers how to implement passkey authentication in your applications using Ory Kratos or Ory Network. Passkeys provide a
 passwordless authentication experience using WebAuthn across web browsers and mobile platforms.
@@ -52,7 +54,7 @@ The script automatically:
 - Calls `navigator.credentials.get()` for authentication.
 - Submits the WebAuthn response back to Ory.
 
-See [Custom UI Advanced Integration](../bring-your-own-ui/custom-ui-advanced-integration#passwordless-authentication.mdx) for
+See [Custom UI Advanced Integration](../bring-your-own-ui/10_custom-ui-advanced-integration.mdx#passwordless-authentication) for
 details on using `webauthn.js` in custom UIs.
 
 ### Manual WebAuthn integration

@@ -230,8 +230,8 @@ proper session. The `hd` parameter limits the login/registration process to a Go
 
 The parameters can be passed along to Ory on `login`, `registration` and `settings` flows on form submit.
 
-See the [Advanced Integration](../bring-your-own-ui/custom-ui-advanced-integration#upstream-provider-parameters) document for more
-information on passing parameters from your UI to Ory.
+See the [Advanced Integration](../bring-your-own-ui/10_custom-ui-advanced-integration.mdx#upstream-provider-parameters) document
+for more information on passing parameters from your UI to Ory.
 
 ### Account linking
 

@@ -5,7 +5,7 @@ sidebar_label: Understand your current IAM system
 sidebar_position: 1
 ---
 
-# Understand your current IAM system
+# Migrating to Ory — Understand your current IAM system
 
 Before you can migrate smoothly, you need a complete picture of how your identity management system works today. This step ensures
 nothing gets missed—from everyday login flows to rare edge cases—and sets the foundation for mapping existing functionality to Ory