docs(self-hosted): move 'Configuration' to its' own section (#15600)

aldy505 · web-flow · commit 8beb5cf8a73b · 2025-12-07T01:22:08.000Z
Now it's spreading out, and self-hosted docs shouldn't always be about
configuration, sometimes it should explain how things works
diff --git a/develop-docs/integrations/github.mdx b/develop-docs/integrations/github.mdx
@@ -59,7 +59,7 @@ When prompted to subscribe to events, choose the following:
 
 <Alert title="Trick">
   Enabling optional permissions will also enable the{" "}
-  <Link to="/self-hosted/sso/#github-auth">GitHub SSO</Link> for your instance.
+  <Link to="/self-hosted/configuration/sso/#github-auth">GitHub SSO</Link> for your instance.
 </Alert>
 
 You'll be given various credentials, configure them in `config.yml`:
diff --git a/develop-docs/self-hosted/backup.mdx b/develop-docs/self-hosted/backup.mdx
@@ -1,7 +1,7 @@
 ---
 title: Self-Hosted Backup & Restore
 sidebar_title: Backup & Restore
-sidebar_order: 20
+sidebar_order: 6
 description: Learn how to backup and restore your self-hosted Sentry data using various methods
 ---
 
diff --git a/develop-docs/self-hosted/configuration/custom-ca-roots.mdx b/develop-docs/self-hosted/configuration/custom-ca-roots.mdx
diff --git a/develop-docs/self-hosted/configuration/email.mdx b/develop-docs/self-hosted/configuration/email.mdx
diff --git a/develop-docs/self-hosted/configuration/geolocation.mdx b/develop-docs/self-hosted/configuration/geolocation.mdx
diff --git a/develop-docs/self-hosted/configuration/index.mdx b/develop-docs/self-hosted/configuration/index.mdx
@@ -23,9 +23,9 @@ You very likely will want to adjust the default configuration for your Sentry in
 
 1. **Environment variables**—The available keys are defined in [.env](https://github.com/getsentry/self-hosted/blob/master/.env). Use some system-dependent means of setting environment variables if you need to override any of them. To avoid Git changes, simply create a file called `.env.custom` and insert your system-dependent environment variables there. In order to use this, please use `docker compose --env-file /path/to/.env.custom up --wait`.
 
-1. [Geolocation](/self-hosted/geolocation/) uses **a custom configuration file** to conform to the underlying technology.
+1. [Geolocation](/self-hosted/configuration/geolocation/) uses **a custom configuration file** to conform to the underlying technology.
 
-You can find more about configuring Sentry at [the configuration section of our developer documentation](/config/).
+You can find more about configuring Sentry at [the configuration section of our developer documentation](/backend/config/).
 
 <Alert title="Note">
   Once you change your configuration, it's highly recommended to re-run <code>./install.sh</code> script rather than restarting all services using <code>docker compose restart</code>. This ensures no other configuration or migrations that might be missing when something is toggled on.
@@ -73,9 +73,9 @@ docker compose --env-file .env --env-file .env.custom up --wait
 
 Here is further information on specific configuration topics related to self-hosting:
 
-- [Custom CA Roots](/self-hosted/custom-ca-roots/)
-- [Email](/self-hosted/email/)
-- [Geolocation](/self-hosted/geolocation/)
-- [Single Sign-On (SSO)](/self-hosted/sso/)
+- [Custom CA Roots](/self-hosted/configuration/custom-ca-roots/)
+- [Email](/self-hosted/configuration/email/)
+- [Geolocation](/self-hosted/configuration/geolocation/)
+- [Single Sign-On (SSO)](/self-hosted/configuration/sso/)
 - [Content Security Policy](/self-hosted/optional-features/csp/)
 - [Errors Only](/self-hosted/optional-features/errors-only/)
diff --git a/develop-docs/self-hosted/configuration/sso.mdx b/develop-docs/self-hosted/configuration/sso.mdx
diff --git a/develop-docs/self-hosted/data-flow.mdx b/develop-docs/self-hosted/data-flow.mdx
@@ -1,7 +1,7 @@
 ---
 title: Self-hosted Data Flow
 sidebar_title: Data Flow
-sidebar_order: 20
+sidebar_order: 7
 description: Learn about the data flow of self-hosted Sentry
 ---
 
@@ -95,4 +95,3 @@ graph LR
 
 1. The `web` service is what you see, it's the Django web UI and API that serves the Sentry's frontend.
 2. The `worker` service mainly consumes tasks from  `redis` that acts as a celery queue. One notable task is to send emails through the SMTP server.
-
diff --git a/develop-docs/self-hosted/optional-features/index.mdx b/develop-docs/self-hosted/optional-features/index.mdx
@@ -1,7 +1,7 @@
 ---
 title: Self-Hosted Optional Features
 sidebar_title: Optional Features
-sidebar_order: 60
+sidebar_order: 3
 ---
 
 <PageGrid />
diff --git a/develop-docs/self-hosted/production-enhancements/index.mdx b/develop-docs/self-hosted/production-enhancements/index.mdx
@@ -1,7 +1,7 @@
 ---
 title: Self-Hosted Production Enhancements
 sidebar_title: Production Enhancements
-sidebar_order: 50
+sidebar_order: 4
 ---
 
 In order to make your self-hosted Sentry installation more production-ready, we provide some additional guides to help you optimize your Sentry instance.
diff --git a/develop-docs/self-hosted/reference-architecture/index.mdx b/develop-docs/self-hosted/reference-architecture/index.mdx
@@ -1,7 +1,7 @@
 ---
 title: Self-Hosted Reference Architectures
 sidebar_title: Reference Architectures
-sidebar_order: 3
+sidebar_order: 5
 ---
 
 This section contains reference architectures for self-hosted Sentry other than the default single-node setup. These are not meant to be used as-is, but as a reference for how to deploy self-hosted Sentry around your existing infrastructure. This section can be used to create a scaling strategy if you have higher traffic loads over time.
diff --git a/develop-docs/self-hosted/releases.mdx b/develop-docs/self-hosted/releases.mdx
@@ -23,7 +23,7 @@ We encourage everyone to regularly update their Sentry installations to get the
 
 Before starting the upgrade, we shut down all the services and then run some data migrations, so expect to have some downtime. There is an *experimental* `--minimize-downtime` option to reduce the downtime during upgrades. Use this at your own risk and see [the pull request it was implemented in](https://github.com/getsentry/self-hosted/issues/607) for more information.
 
-We assume you've cloned the self-hosted repository, so checkout the version you want to upgrade to (23.11.0 as an example).
+We assume you've cloned the self-hosted repository, so checkout the version you want to upgrade to (25.7.0 as an example).
 
 ```bash
 git fetch
@@ -80,8 +80,10 @@ We provide nightly builds from the [master branch of the self-hosted repository
 - [Relay](https://github.com/getsentry/relay)
 - [Symbolicator](https://github.com/getsentry/symbolicator)
 - [Vroom](https://github.com/getsentry/vroom)
+- [Uptime Checker](https://github.com/getsentry/uptime-checker)
+- [Taskbroker](https://github.com/getsentry/taskbroker)
 
-These builds are usually stable, but you may occasionally hit a broken version as these versions are not guaranteed to be deployed to [sentry.io](http://sentry.io/) first. There is also no guarantee that you will be able to do a clean upgrade to later versions without losing any data. **Use the nightly builds at your own risk.**
+These builds are usually stable, but you may occasionally hit a broken version as these versions are not guaranteed to be deployed to [sentry.io](http://sentry.io/) first. There is also no guarantee that you will be able to do a clean upgrade to later versions without losing any data. **Use the nightly builds at your own risk.**
 
 ## Breaking Changes
 
diff --git a/develop-docs/self-hosted/tasks.mdx b/develop-docs/self-hosted/tasks.mdx
@@ -1,6 +1,6 @@
 ---
 title: Tasks
-sidebar_order: 70
+sidebar_order: 8
 ---
 
 ## System Architecture
diff --git a/redirects.js b/redirects.js
@@ -218,6 +218,22 @@ const developerDocsRedirects = [
     source: '/services/emails/',
     destination: '/backend/emails/',
   },
+  {
+    source: '/self-hosted/custom-ca-roots/',
+    destination: '/self-hosted/configuration/custom-ca-roots/',
+  },
+  {
+    source: '/self-hosted/email/',
+    destination: '/self-hosted/configuration/email/',
+  },
+  {
+    source: '/self-hosted/geolocation/',
+    destination: '/self-hosted/configuration/geolocation/',
+  },
+  {
+    source: '/self-hosted/sso/',
+    destination: '/self-hosted/configuration/sso/',
+  },
 ];
 
 /** @type {import('next/dist/lib/load-custom-routes').Redirect[]} */
