kcmartin · Oct 21, 2026 · Oct 19, 2026 · Oct 20, 2026
diff --git a/api/machines/index.mdx b/api/machines/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: "Machines API overview"
+description: "Base URL, Bearer token auth, and OpenAPI spec for the Fly.io Machines API, with links to Apps, Machines, Volumes, Secrets, and Certificates endpoints."
 sidebarTitle: "Overview"
 icon: book-open
 ---

diff --git a/apps/app-availability.mdx b/apps/app-availability.mdx
@@ -1,5 +1,6 @@
 ---
 title: App Availability and Resiliency
+description: "Fly.io resiliency features, from two Machines per process group and standby Machines to health check routing, and what your app must handle itself."
 source_url: https://fly.io/docs/apps/app-availability/
 ---
 

diff --git a/apps/app-handover-guide.mdx b/apps/app-handover-guide.mdx
@@ -1,5 +1,6 @@
 ---
 title: App handover guide
+description: "Hand an app to a client on Fly.io: build in their org from day one, or run fly apps move and rebuild Postgres, Upstash Redis, and Tigris by hand."
 source_url: https://fly.io/docs/apps/app-handover-guide/
 ---
 

diff --git a/apps/concurrency.mdx b/apps/concurrency.mdx
@@ -1,5 +1,6 @@
 ---
 title: Guidelines for concurrency settings
+description: "Set soft_limit, hard_limit, and connections vs requests concurrency in fly.toml, and see how Fly Proxy uses them for load balancing and autostop."
 source_url: https://fly.io/docs/apps/concurrency/
 ---
 

diff --git a/apps/delete.mdx b/apps/delete.mdx
@@ -1,5 +1,6 @@
 ---
 title: Delete an app
+description: "Permanently delete a Fly App with fly apps destroy, removing its Machines, volumes, snapshots, IPs, secrets, and images and ending charges."
 source_url: https://fly.io/docs/apps/delete/
 ---
 

diff --git a/apps/fine-tune-apps.mdx b/apps/fine-tune-apps.mdx
@@ -1,5 +1,6 @@
 ---
 title: Tips to fine-tune your app on Fly.io
+description: "Benchmark an app on Fly.io: compare edge and app response metrics, check routing with debug.fly.dev, and factor in concurrency and autostop."
 source_url: https://fly.io/docs/apps/fine-tune-apps/
 ---
 

diff --git a/apps/going-to-production.mdx b/apps/going-to-production.mdx
@@ -1,5 +1,6 @@
 ---
 title: Going to production checklist
+description: "Production checklist for Fly.io apps: SSO, tokens, secrets, Managed Postgres, Machine sizing, multi-region scaling, custom domains, metrics, CI/CD."
 source_url: https://fly.io/docs/apps/going-to-production/
 ---
 

diff --git a/apps/index.mdx b/apps/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Apps on Fly.io
+description: "Fly Apps docs hub: Fly Launch for deploying and scaling, runtime and build secrets, and production guides on availability, tuning, and concurrency."
 source_url: https://fly.io/docs/apps/
 ---
 

diff --git a/apps/info.mdx b/apps/info.mdx
@@ -1,5 +1,6 @@
 ---
 title: Get information about an app
+description: "Inspect a running Fly App with fly status, fly machine status, fly ips list, fly config show, fly ssh console, and fly logs, with sample output."
 source_url: https://fly.io/docs/apps/info/
 ---
 

diff --git a/apps/move-app-org.mdx b/apps/move-app-org.mdx
@@ -1,5 +1,6 @@
 ---
 title: Move an app between organizations
+description: "Move an app to another Fly.io org with fly apps move or the dashboard. Expect brief downtime and reconfigure Upstash Redis, Tigris, and Postgres."
 source_url: https://fly.io/docs/apps/move-app-org/
 ---
 

diff --git a/apps/restart.mdx b/apps/restart.mdx
@@ -1,5 +1,6 @@
 ---
 title: Restart apps or Machines
+description: "Restart all Fly Launch Machines in an app with fly apps restart, or reboot specific Machines by ID with fly machine restart to reset the root filesystem."
 source_url: https://fly.io/docs/apps/restart/
 ---
 

diff --git a/kubernetes/clusters.mdx b/kubernetes/clusters.mdx
@@ -1,5 +1,6 @@
 ---
 title: Create an FKS cluster
+description: "Create a Fly Kubernetes cluster with fly ext k8s create, get its kubeconfig, and run kubectl over WireGuard. FKS is in closed beta."
 source_url: https://fly.io/docs/kubernetes/clusters/
 ---
 

diff --git a/kubernetes/connect-clusters.mdx b/kubernetes/connect-clusters.mdx
@@ -1,5 +1,6 @@
 ---
 title: Connect to an FKS cluster
+description: "Connect kubectl to an FKS cluster: set up a WireGuard VPN, list clusters with fly ext k8s ls, and save credentials with fly ext k8s save-kubeconfig."
 source_url: https://fly.io/docs/kubernetes/connect-clusters/
 ---
 

diff --git a/kubernetes/fks-features.mdx b/kubernetes/fks-features.mdx
@@ -1,5 +1,6 @@
 ---
 title: Fly Kubernetes features
+description: "How Fly Kubernetes runs on Fly Machines, Fly Volumes, and WireGuard, its token auth and security, and unsupported features like DaemonSets."
 source_url: https://fly.io/docs/kubernetes/fks-features/
 ---
 

diff --git a/kubernetes/fks-quickstart.mdx b/kubernetes/fks-quickstart.mdx
@@ -1,5 +1,6 @@
 ---
 title: Fly Kubernetes Quickstart
+description: "Spin up an FKS cluster, connect over WireGuard, and deploy an nginx Deployment with kubectl, plus the pod and container fields FKS doesn't support."
 source_url: https://fly.io/docs/kubernetes/fks-quickstart/
 ---
 

diff --git a/kubernetes/services.mdx b/kubernetes/services.mdx
@@ -1,5 +1,6 @@
 ---
 title: Configure FKS Services
+description: "Expose FKS workloads with ClusterIP and LoadBalancer Services, and set handlers, TLS options, and concurrency limits via service.fly.io annotations."
 source_url: https://fly.io/docs/kubernetes/services/
 ---
 

diff --git a/kubernetes/using-volumes.mdx b/kubernetes/using-volumes.mdx
@@ -1,5 +1,6 @@
 ---
 title: Using volumes with FKS
+description: "Use PersistentVolumeClaims and generic ephemeral volumes in FKS, backed by Fly Volumes, with the flyio-volume and flyio-volume-retain classes."
 source_url: https://fly.io/docs/kubernetes/using-volumes/
 ---
 

diff --git a/launch/autoscale-by-metric.mdx b/launch/autoscale-by-metric.mdx
@@ -1,5 +1,6 @@
 ---
 title: Autoscale based on metrics
+description: "Deploy fly-autoscaler to scale worker Machines on Prometheus queue depth or Temporal workflows, using FAS_ env vars and Expr Machine counts."
 source_url: https://fly.io/docs/launch/autoscale-by-metric/
 ---
 

diff --git a/launch/volume-storage.mdx b/launch/volume-storage.mdx
@@ -1,5 +1,6 @@
 ---
 title: Add volume storage to a Fly Launch app
+description: "Attach Fly Volumes to a Fly Launch app: add [mounts] to fly.toml, create one volume per Machine and region, deploy, and verify with fly volumes list."
 source_url: https://fly.io/docs/launch/volume-storage/
 ---
 

diff --git a/machines/api/apps-resource.mdx b/machines/api/apps-resource.mdx
@@ -1,5 +1,6 @@
 ---
 title: Apps
+description: "Machines API Apps resource: create, get, list by org_slug, and delete Fly Apps, plus allocating IPs, setting secrets, and isolated app networks."
 ---
 
 You can use the Apps resource to create and manage Fly Apps. A Fly App is an abstraction for a group of Machines running your code, along with the configuration, provisioned resources, and data we need to keep track of to run and route to your Machines. Learn more about [Fly Apps](/apps/overview).

diff --git a/machines/api/certificates-resource.mdx b/machines/api/certificates-resource.mdx
@@ -1,5 +1,6 @@
 ---
 title: Certificates
+description: "Manage custom domain certificates via the Machines API: request ACME certs, import PEM certs, check DNS validation, and delete certificates."
 ---
 
 

diff --git a/machines/api/tokens-resource.mdx b/machines/api/tokens-resource.mdx
@@ -1,5 +1,6 @@
 ---
 title: Tokens
+description: "Request an OpenID Connect token for a Fly Machine with POST /v1/tokens/oidc in the Machines API, setting the aud claim to get a signed JWT."
 ---
 
 You can use the Tokens resource to request an OpenID Connect (OIDC) token from a 3rd-party service. Learn more about [using OpenID Connect](/security/openid-connect/) on Fly.io.

diff --git a/machines/api/volumes-resource.mdx b/machines/api/volumes-resource.mdx
@@ -1,5 +1,6 @@
 ---
 title: Volumes
+description: "Volumes endpoints in the Machines API: list, create, update, extend, and delete Fly Volumes, list snapshots, restore from one, or snapshot on demand."
 ---
 
 You can use the Volumes resource to create and delete volumes. A Fly Volume is persistent storage for a Fly Machine. Learn more about [volumes](/volumes/).

diff --git a/machines/guides-examples/functions-with-machines.mdx b/machines/guides-examples/functions-with-machines.mdx
@@ -1,5 +1,6 @@
 ---
 title: Run User Code on Fly Machines
+description: "Build functions-as-a-service on Fly Machines: create an isolated app, launch user-code Machines in any region via the API, then stop or delete them."
 source_url: https://fly.io/docs/machines/guides-examples/functions-with-machines/
 ---
 

diff --git a/machines/guides-examples/machine-placement.mdx b/machines/guides-examples/machine-placement.mdx
@@ -1,5 +1,6 @@
 ---
 title: Machine Placement and Regional Capacity
+description: "Avoid failed scaling when a Fly.io region is out of capacity: give fly machine clone a prioritized region list or aliases like us, eu, and apac."
 source_url: https://fly.io/docs/machines/guides-examples/machine-placement/
 ---
 

diff --git a/machines/guides-examples/machine-restart-policy.mdx b/machines/guides-examples/machine-restart-policy.mdx
@@ -1,5 +1,6 @@
 ---
 title: Machine restart policy
+description: "Compare no, always, and on-fail Machine restart policies, check one with fly m status -d, and change it via fly m update, the API, or fly.toml."
 source_url: https://fly.io/docs/machines/guides-examples/machine-restart-policy/
 ---
 

diff --git a/machines/guides-examples/managing-machines-with-the-api.mdx b/machines/guides-examples/managing-machines-with-the-api.mdx
@@ -1,5 +1,6 @@
 ---
 title: Managing Machines with the Machines API
+description: "Machines API patterns: clone a Machine's config, set fly_process_group metadata so flyctl manages it, define services, and sync autostop/autostart."
 source_url: https://fly.io/docs/machines/guides-examples/managing-machines-with-the-api/
 tag: NEW
 ---

diff --git a/machines/guides-examples/network-policies.mdx b/machines/guides-examples/network-policies.mdx
@@ -1,5 +1,6 @@
 ---
 title: Network Policies
+description: "Restrict Fly Machine ingress and egress with network policies in the Machines API, selecting by app, Machine ID, or metadata with port allow rules."
 source_url: https://fly.io/docs/machines/guides-examples/network-policies/
 ---
 

diff --git a/machines/guides-examples/one-app-per-user-why.mdx b/machines/guides-examples/one-app-per-user-why.mdx
@@ -1,5 +1,6 @@
 ---
 title: One App Per Customer - Why?
+description: "Why Fly.io recommends one app per customer: per-app secrets, load balancing, and scaling, plus isolated networks that can still talk via Flycast."
 source_url: https://fly.io/docs/machines/guides-examples/one-app-per-user-why/
 ---
 

diff --git a/machines/machine-states.mdx b/machines/machine-states.mdx
@@ -1,5 +1,6 @@
 ---
 title: Machine states and lifecycle
+description: "Fly Machine lifecycle states, from created, started, and suspended to replaced and migrated, plus version behavior and how to spot stuck Machines."
 source_url: https://fly.io/docs/machines/machine-states/
 ---
 

diff --git a/monitoring/error-codes.mdx b/monitoring/error-codes.mdx
@@ -1,5 +1,6 @@
 ---
 title: Error codes and troubleshooting
+description: "Look up Fly Proxy error codes like PC01, PT05, PM03, PR01, and PA03 from your app logs, grouped by connection, TLS, Machine, and routing."
 source_url: https://fly.io/docs/monitoring/error-codes/
 ---
 

diff --git a/monitoring/index.mdx b/monitoring/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Monitoring on Fly.io
+description: "Fly.io monitoring docs: managed Prometheus and Grafana metrics, Sentry error tracking, and guides to live tail, log search, the logs API, and export."
 source_url: https://fly.io/docs/monitoring/
 ---
 

diff --git a/monitoring/live-tail-logs.mdx b/monitoring/live-tail-logs.mdx
@@ -1,5 +1,6 @@
 ---
 title: Live tail logs
+description: "Tail Fly App logs live with fly logs, filter by Machine with --instance, turn on LOG_LEVEL=debug for flyctl, or use the dashboard Live Logs page."
 source_url: https://fly.io/docs/monitoring/live-tail-logs/
 ---
 

diff --git a/monitoring/search-logs.mdx b/monitoring/search-logs.mdx
@@ -1,5 +1,6 @@
 ---
 title: Search logs
+description: "Search Fly App logs in Grafana, backed by VictoriaLogs with 7-day retention and LogsQL queries. Log search is in beta and free during the beta."
 source_url: https://fly.io/docs/monitoring/search-logs/
 ---
 

diff --git a/networking/app-services.mdx b/networking/app-services.mdx
@@ -1,5 +1,6 @@
 ---
 title: Connect to an App Service
+description: "Reach a process on a Fly Machine via Fly Proxy or 6PN: which address to bind, when services and IPs are needed, and curl checks for each path."
 source_url: https://fly.io/docs/networking/app-services/
 ---
 

diff --git a/networking/custom-private-networks.mdx b/networking/custom-private-networks.mdx
@@ -1,5 +1,6 @@
 ---
 title: Custom private networks
+description: "Isolate tenants on custom 6PNs with fly apps create --network, connect them via Flycast or fly-replay, and read network IDs from IPv6 addresses."
 source_url: https://fly.io/docs/networking/custom-private-networks/
 ---
 

diff --git a/networking/index.mdx b/networking/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Networking
+description: "Fly.io networking docs: Anycast public services, 6PN private networking, Flycast, egress IPs, fly-replay routing, custom domains, UDP, and TLS."
 source_url: https://fly.io/docs/networking/
 ---
 

diff --git a/networking/tls.mdx b/networking/tls.mdx
@@ -1,5 +1,6 @@
 ---
 title: TLS Support
+description: "Fly Proxy accepts only TLSv1.2 and TLSv1.3. See the AES-GCM and ChaCha20-Poly1305 cipher suites it supports for each, plus SSL Labs results."
 source_url: https://fly.io/docs/networking/tls/
 ---
 

diff --git a/reference/aws-to-fly-guide.mdx b/reference/aws-to-fly-guide.mdx
@@ -1,5 +1,6 @@
 ---
 title: Migrating from AWS to Fly.io Overview
+description: "Moving from AWS to Fly.io: how EC2, EBS, S3, VPCs, RDS, and CloudWatch map to Fly Machines, Volumes, Tigris, 6PN, Managed Postgres, and Grafana."
 source_url: https://fly.io/docs/reference/aws-to-fly-guide/
 ---
 

diff --git a/reference/builders.mdx b/reference/builders.mdx
@@ -1,5 +1,6 @@
 ---
 title: Builders and Fly.io
+description: "Three ways Fly.io builds a deployable image: the default Dockerfile builder, Cloud Native Buildpacks from Paketo or Heroku, or a prebuilt image."
 source_url: https://fly.io/docs/reference/builders/
 ---
 

diff --git a/reference/content-encoding.mdx b/reference/content-encoding.mdx
@@ -1,5 +1,6 @@
 ---
 title: Content Encoding with the Fly Proxy
+description: "HTTP responses get compressed at the Fly Proxy edge with zstd, Brotli, gzip, or deflate per Accept-Encoding. Set Content-Encoding: none to stream HTML."
 source_url: https://fly.io/docs/reference/content-encoding/
 ---
 

diff --git a/reference/extensions_api.mdx b/reference/extensions_api.mdx
@@ -1,5 +1,6 @@
 ---
 title: Provisioning Fly.io Extensions
+description: "Spec for Fly.io extension partners: signed provisioning requests, Flycast private access, OAuth SSO, resource webhooks, and billing."
 source_url: https://fly.io/docs/reference/extensions_api/
 ---
 

diff --git a/reference/index.mdx b/reference/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Fly.io reference
+description: "Fly.io reference index: architecture, regions, Machine migration, flyctl, fly.toml, Fly Proxy, autostop, health checks, builders, load balancing."
 source_url: https://fly.io/docs/reference/
 ---
 

diff --git a/reference/load-balancing.mdx b/reference/load-balancing.mdx
@@ -1,5 +1,6 @@
 ---
 title: Load Balancing
+description: "How Fly Proxy routes each request by soft_limit and hard_limit load and RTT closeness, with a worked example of traffic spilling across regions."
 source_url: https://fly.io/docs/reference/load-balancing/
 ---
 

diff --git a/reference/machine-migration.mdx b/reference/machine-migration.mdx
@@ -1,5 +1,6 @@
 ---
 title: Machine migration
+description: "What happens when Fly.io moves a Machine to a new host: stop via kill_signal, volume fork, new 6PN address, and migrated=true in event logs."
 source_url: https://fly.io/docs/reference/machine-migration/
 ---
 

diff --git a/security/arcjet.mdx b/security/arcjet.mdx
@@ -1,5 +1,6 @@
 ---
 title: Application Security by Arcjet
+description: "Add Arcjet rate limiting, bot protection, and email validation to a Fly.io app with fly ext arcjet create, then the Node.js or Python FastAPI SDK."
 source_url: https://fly.io/docs/security/arcjet/
 ---
 

diff --git a/security/index.mdx b/security/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Security
+description: "Fly.io security docs: org roles, SSO, member offboarding, TLS termination, Arcjet, access tokens, OpenID Connect, and shared responsibility."
 source_url: https://fly.io/docs/security/
 ---
 

diff --git a/security/org-roles-permissions.mdx b/security/org-roles-permissions.mdx
@@ -1,5 +1,6 @@
 ---
 title: Organization Roles and Permissions
+description: "Member vs Admin roles in a Fly.io organization, and how to limit risk by splitting dev and prod into separate orgs and using read-only tokens."
 source_url: https://fly.io/docs/security/org-roles-permissions/
 ---
 

diff --git a/security/remove-org-member.mdx b/security/remove-org-member.mdx
@@ -1,5 +1,6 @@
 ---
 title: Remove a member from your organization
+description: "Offboard a user from a Fly.io org: remove them in the dashboard, delete WireGuard peers, revoke tokens, unset secrets, and rotate passwords."
 source_url: https://fly.io/docs/security/remove-org-member/
 ---
 

diff --git a/security/shared-responsibility.mdx b/security/shared-responsibility.mdx
@@ -1,5 +1,6 @@
 ---
 title: Shared responsibility model
+description: "Fly.io's shared responsibility model: what Fly secures, like workers, edges, and Fly Proxy, versus what you own in your image, tokens, and SSO."
 source_url: https://fly.io/docs/security/shared-responsibility/
 ---
 

diff --git a/security/sso.mdx b/security/sso.mdx
@@ -1,5 +1,6 @@
 ---
 title: Single sign-on for organizations
+description: "Require Google Workspace or GitHub single sign-on for a Fly.io organization from the dashboard, and how org SSO differs from user login."
 source_url: https://fly.io/docs/security/sso/
 ---
 

diff --git a/security/tls-termination.mdx b/security/tls-termination.mdx
@@ -1,5 +1,6 @@
 ---
 title: TLS termination by Fly Proxy
+description: "Fly Proxy terminates TLS on port 443 using Let's Encrypt or imported certificates. Remove the tls handler to terminate TLS in your own app."
 source_url: https://fly.io/docs/security/tls-termination/
 ---
 

diff --git a/volumes/index.mdx b/volumes/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Fly Volumes
+description: "Fly Volumes docs index: how NVMe volumes work, adding them to Fly Launch apps, managing them with flyctl, snapshots, states, and the Volumes API."
 source_url: https://fly.io/docs/volumes/
 ---
 

diff --git a/volumes/snapshots.mdx b/volumes/snapshots.mdx
@@ -1,5 +1,6 @@
 ---
 title: Manage volume snapshots
+description: "Manage Fly Volume snapshots: set 1 to 60 day retention, create one with fly volumes snapshots create, restore to a new volume, or disable them."
 source_url: https://fly.io/docs/volumes/snapshots/
 ---
 

diff --git a/volumes/volume-states.mdx b/volumes/volume-states.mdx
@@ -1,5 +1,6 @@
 ---
 title: Volume states
+description: "Every Fly Volume state, from creating and hydrating to pending_destroy, the transitions for each action, and how long soft-deleted volumes last."
 source_url: https://fly.io/docs/volumes/volume-states/
 ---