ory · wassimoo · Jun 8, 2026 · Jun 11, 2026 · Jun 15, 2026 · Jun 15, 2026
@@ -186,6 +186,8 @@ import MyPartial from "@site/src/components/Shared/kratos/index.mdx"
 - Can’t find a page → check `docs/network`, `docs/oel`, `docs/oss`
 - Duplicate content → always set canonical URLs
 - Adding a page → update the correct sidebar
+- Deleting a page → never delete without adding a Vercel redirect from the old
+  URL to a relevant replacement
 
 ## When in Doubt
 

@@ -10,7 +10,7 @@ import Secure from '../../_common/secure.mdx'
 ```
 
 ```mdx-code-block
-import Install from '../../_common/install.mdx'
+import Install from '@site/src/components/Shared/install.mdx'
 
 <Install repo="hydra" command="hydra" name="Ory Hydra" />
 ```
@@ -9,6 +9,9 @@ import Tabs from "@theme/Tabs"
 import TabItem from "@theme/TabItem"
 import CodeBlock from '@theme/CodeBlock'
 import { FrameworkCodeTabs } from '@site/src/components/GuidesComponents'
+import Linux from '@site/src/components/Install/Linux'
+import MacOS from '@site/src/components/Install/MacOS'
+import Windows from '@site/src/components/Install/Windows'
 import nextDevSetup from '!!raw-loader!./_common/code-examples/nextjs/ory.ts'
 import goSetup from '!!raw-loader!./_common/code-examples/go/ory_client.go'
 import jsDevSetup from '!!raw-loader!./_common/code-examples/js/setupDev.js'
@@ -69,23 +72,33 @@ For local development, you'll need to use Ory Tunnel to connect your local appli
   values={[
     {label: 'macOS', value: 'macos'},
     {label: 'Linux', value: 'linux'},
+    {label: 'Windows', value: 'windows'},
   ]}>
 <TabItem value="macos">
 ```
 
-```shell
-# Install Ory CLI using Homebrew
-brew install ory/tap/cli
-
-# Verify installation
-ory help
+```mdx-code-block
+<MacOS repo="cli" command="ory" name="the Ory CLI" />
 ```
 
 ```mdx-code-block
 </TabItem>
 <TabItem value="linux">
 ```
 
+```mdx-code-block
+<Linux repo="ory" name="the Ory CLI" />
+```
+
+```mdx-code-block
+</TabItem>
+<TabItem value="windows">
+```
+
+```mdx-code-block
+<Windows repo="ory" name="the Ory CLI" />
+```
+
 ```mdx-code-block
 </TabItem>
 </Tabs>
@@ -94,10 +107,13 @@ ory help
 After installing the CLI, start the tunnel to connect your local application with Ory's APIs:
 
 ```shell
-# Start the tunnel (replace with your project id)
-ory tunnel --project $PROJECT_ID http://localhost:3000
+ory tunnel --project $ORY_PROJECT_ID --port 4000 http://localhost:3000
 ```
 
+This proxies Ory's APIs on `http://localhost:4000` and forwards all other traffic to your application at `http://localhost:3000`.
+Running the tunnel is required for local development because Ory's session cookies must be set on the same domain as your
+application.
+
 :::tip
 
 To learn more about the Ory Tunnel, read the [dedicated section of the Ory CLI documentation](../../guides/cli/proxy-and-tunnel).

@@ -4,7 +4,7 @@ title: Installation
 ---
 
 ```mdx-code-block
-import Install from '../_common/install.mdx'
+import Install from '@site/src/components/Shared/install.mdx'
 
 <Install repo="oathkeeper" name="Ory Oathkeeper" />
 ```
@@ -0,0 +1,20 @@
+---
+id: install
+title: Installation
+---
+
+<head>
+  <link rel="canonical" href="https://www.ory.com/docs/oel/keto/install" />
+</head>
+
+```mdx-code-block
+import Secure from '@site/docs/_common/secure.mdx'
+
+<Secure />
+```
+
+```mdx-code-block
+import Install from '@site/docs/_common/install.mdx'
+
+<Install repo="keto" name="Ory Keto" />
+```
@@ -0,0 +1,20 @@
+---
+id: install
+title: Installation
+---
+
+<head>
+  <link rel="canonical" href="https://www.ory.com/docs/oel/kratos/install" />
+</head>
+
+```mdx-code-block
+import Secure from '@site/docs/_common/secure.mdx'
+
+<Secure />
+```
+
+```mdx-code-block
+import Install from '@site/src/components/Shared/install.mdx'
+
+<Install repo="kratos" name="Ory Kratos" />
+```
@@ -0,0 +1,20 @@
+---
+id: install
+title: Installation
+---
+
+<head>
+  <link rel="canonical" href="https://www.ory.com/docs/oel/keto/install" />
+</head>
+
+```mdx-code-block
+import Secure from '@site/docs/_common/secure.mdx'
+
+<Secure />
+```
+
+```mdx-code-block
+import Install from '@site/docs/_common/install.mdx'
+
+<Install repo="keto" name="Ory Keto" />
+```
@@ -0,0 +1,20 @@
+---
+id: install
+title: Installation
+---
+
+<head>
+  <link rel="canonical" href="https://www.ory.com/docs/oel/kratos/install" />
+</head>
+
+```mdx-code-block
+import Secure from '@site/docs/_common/secure.mdx'
+
+<Secure />
+```
+
+```mdx-code-block
+import Install from '@site/src/components/Shared/install.mdx'
+
+<Install repo="kratos" name="Ory Kratos" />
+```
@@ -50,7 +50,7 @@ const oelSidebar = [
         className: "sidebar-icon sidebar-icon-kratos",
         items: [
           "oel/kratos/intro",
-          "kratos/install",
+          "oel/kratos/install",
           "self-hosted/oel/kratos/upgrade",
           "self-hosted/oel/kratos/changelog",
           "oel/kratos/quickstart",
@@ -130,7 +130,7 @@ const oelSidebar = [
         className: "sidebar-icon sidebar-icon-keto",
         items: [
           "oel/keto/index",
-          "keto/install",
+          "oel/keto/install",
           "keto/guides/v0.7-migration",
           "keto/guides/migrating-legacy-policies",
           "keto/guides/upgrade",

@@ -58,9 +58,8 @@ const ossSidebar = [
         className: "sidebar-icon sidebar-icon-kratos",
         items: [
           "oss/kratos/intro",
-          "kratos/install",
+          "oss/kratos/install",
           "kratos/guides/upgrade",
-          "self-hosted/oel/kratos/changelog",
           "oss/kratos/quickstart",
           {
             type: "category",
@@ -138,12 +137,11 @@ const ossSidebar = [
         className: "sidebar-icon sidebar-icon-keto",
         items: [
           "oss/keto/index",
-          "keto/install",
+          "oss/keto/install",
           "keto/guides/v0.7-migration",
           "keto/guides/migrating-legacy-policies",
           "keto/guides/upgrade",
           "oss/keto/quickstart",
-          "self-hosted/oel/keto/changelog",
           {
             type: "category",
             label: "Configuration",
@@ -187,7 +185,6 @@ const ossSidebar = [
           "self-hosted/oel/oauth2/revert-database-migrations",
           "self-hosted/oel/oauth2/upgrade",
           "hydra/self-hosted/upgrade",
-          "self-hosted/oel/oauth2/changelog",
           "oel/hydra/quickstart",
           {
             type: "category",
@@ -255,7 +252,6 @@ const ossSidebar = [
         items: [
           "oss/polis/index",
           "polis/install",
-          "self-hosted/oel/polis/changelog",
           "oel/polis/quickstart",
           {
             type: "category",
@@ -432,7 +428,6 @@ const ossSidebar = [
           "oss/oathkeeper/index",
           "oathkeeper/install",
           "self-hosted/oel/oathkeeper/upgrade-oathkeeper",
-          "self-hosted/oel/oathkeeper/changelog",
           {
             type: "category",
             label: "Configure",