From 506dd5469cbbad802c34d38cc56bfde73a904d7a Mon Sep 17 00:00:00 2001
From: Alex Leventer <alexleventer@gmail.com>
Date: Sun, 18 Oct 2026 20:39:51 -0700
Subject: [PATCH] Redirect old docs URLs that external sites still link to

Ahrefs' broken-backlinks report (2026-10-18) lists 25 fly.io/docs paths
that now land on docs.fly.io 404s, linked from supabase.com, Docker Hub,
savvycal.com, GitHub, GitLab, YC, dashbit.co and others. Each goes to the
closest live page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 docs.json | 100 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 100 insertions(+)

diff --git a/docs.json b/docs.json
index 54a6baaac1..20ede94a39 100644
--- a/docs.json
+++ b/docs.json
@@ -4102,6 +4102,106 @@
     {
       "source": "/flyctl/cmd/fly",
       "destination": "/flyctl/cmd/fly_help"
+    },
+    {
+      "source": "/future",
+      "destination": "/"
+    },
+    {
+      "source": "/introduction",
+      "destination": "/"
+    },
+    {
+      "source": "/reference/ci-cd",
+      "destination": "/launch/continuous-deployment-with-github-actions"
+    },
+    {
+      "source": "/launch/continuous-deployment/github-actions",
+      "destination": "/launch/continuous-deployment-with-github-actions"
+    },
+    {
+      "source": "/flyctl/extensions-tigris-list",
+      "destination": "/flyctl/cmd/fly_storage_list"
+    },
+    {
+      "source": "/about/security",
+      "destination": "/security/security-at-fly-io"
+    },
+    {
+      "source": "/about/privacy",
+      "destination": "https://fly.io/legal/privacy-policy/"
+    },
+    {
+      "source": "/getting-started/login-to-fly",
+      "destination": "/getting-started/sign-up-sign-in"
+    },
+    {
+      "source": "/getting-help",
+      "destination": "/about/support"
+    },
+    {
+      "source": "/getting-started/deploying-your-app",
+      "destination": "/getting-started/launch"
+    },
+    {
+      "source": "/getting-started/installing-fly",
+      "destination": "/flyctl/install"
+    },
+    {
+      "source": "/hands-on/install-cli",
+      "destination": "/flyctl/install"
+    },
+    {
+      "source": "/cli",
+      "destination": "/flyctl"
+    },
+    {
+      "source": "/reference/config",
+      "destination": "/reference/configuration"
+    },
+    {
+      "source": "/reference/enveloop",
+      "destination": "/about/extensions"
+    },
+    {
+      "source": "/reference/machines-api",
+      "destination": "/machines/api"
+    },
+    {
+      "source": "/app-guides/axum-with-rust",
+      "destination": "/rust/frameworks/axum"
+    },
+    {
+      "source": "/app-guides/speed-up-a-heroku-app",
+      "destination": "https://fly.io/learn/heroku-alternatives/"
+    },
+    {
+      "source": "/apps/legacy-scaling",
+      "destination": "/launch/scale-count"
+    },
+    {
+      "source": "/elixir/the-basics/naming-your-elixir-node",
+      "destination": "/elixir/the-basics/clustering"
+    },
+    {
+      "source": "/languages-and-frameworks/django",
+      "destination": "/django"
+    },
+    {
+      "source": "/languages-and-frameworks/svelte",
+      "destination": "/js/frameworks/svelte"
+    },
+    {
+      "source": "/languages-and-frameworks/bun",
+      "destination": "/js"
+    },
+    {
+      "source": "/js/frameworks/bun",
+      "destination": "/js"
+    },
+    {
+      "source": "/about/sprites",
+      "destination": "/sprites"
     }
   ]
 }