Remove deprecated Fly GPUs docs - #2449
Merged
Merged
Conversation
GPUs became unavailable after August 1, so remove the five pages that were left in place carrying deprecation warnings, along with the Fly GPUs section in the side nav and the "Use GPUs with FKS" link under Fly Kubernetes. Also drops the "Try out Fly GPUs" link from the launch demo, which would otherwise 404. Part of the GPU deprecation work tracked in docs-tracking#241.
Now that GPUs are gone, drop the mentions that either described GPUs as an available product or carried an "as of 08/01/26" deprecation date that has since passed: - pricing: the GPU-enabled Machines section and the note about GPUs being billed separately - free trial, support, suspend/resume: GPU bullets with EOL dates - troubleshooting: the 50GB GPU image size exception, leaving the 8GB limit that now applies to all Machines - volumes overview: the --vm-gpu-kind volume placement hint - deep dive index and the Elixir home clustering guide: GPU-based AI/ML framing - shared-nothing blueprint: the Whisper on GPUs aside Leaves the Machines API and fly machine run references alone, since whether they still accept gpu_kind is a platform question.
The compute hint on fly volumes create is not GPU-specific: flyctl sends every --vm-* flag through as compute_requirements, and the scheduler uses it to pick a host with capacity for the Machine you plan to attach. Bring the paragraph back with a --vm-size example and say what goes wrong without a hint.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary of changes
GPUs became unavailable after August 1, so this removes the remaining GPU documentation.
Pages removed (the five listed as "Primary GPU Docs" in docs-tracking#241, all of which were left in place carrying deprecation warnings):
gpus/index.html.mdgpus/gpu-quickstart.html.markerbgpus/getting-started-gpus.html.mdgpus/python-gpu-example.html.mdkubernetes/using-gpus.html.markerbSide nav: removed the Fly GPUs section and the "Use GPUs with FKS" link under Fly Kubernetes.
Stale references cleaned up on pages that remain, either because they described GPUs as an available product or because they carried an "as of 08/01/26" deprecation date that has now passed:
about/pricing.html.markerbabout/free-trial.html.mdabout/support.html.mdreference/suspend-resume.html.mdgetting-started/troubleshooting.html.mddeep-dive/index.html.markerbelixir/advanced-guides/clustering-from-home-to-your-app-in-fly.html.mdblueprints/shared-nothing.html.markerbgetting-started/launch-demo.html.markerbNo redirects, matching how the enveloop and Upstash Kafka removals were handled.
Preview
Check that the Fly GPUs section is gone from the docs side nav, and that Fly Kubernetes no longer lists "Use GPUs with FKS".
Related Fly.io community and GitHub links
Part of the GPU deprecation work tracked in superfly/docs-tracking#241, which deferred these pages when the rest of the audit was completed in #2362.
Notes
volumes/overview.html.markerbkeeps its volume placement paragraph, rewritten with a--vm-size=performance-4xexample instead of--vm-gpu-kind=l40s. The compute hint is not GPU-specific: flyctl passes every--vm-*flag through ascompute_requirements, and the scheduler uses it to pick a host with capacity for the Machine you plan to attach.Deliberately left alone:
machines/api/machines-resource.html.markerbandmachines/flyctl/fly-machine-run.html.mdstill documentgpu_kind/gpusand--vm-gpu-kind. docs-tracking#241 said to leave the API reference until deprecation, and that gate has now passed, but whether the API and flyctl still accept these is a platform question.flyctl/cmd/*will drop the flags on their own when the bot next syncs.partials/gpus/_ollama-create.erb,deep-dive/whisper.html.markerb, andpython/do-more/add-ollama.html.markerbwere deferred to a separate PR in docs-tracking#241. All arepublished: falseor only reachable from a page that is, so the dead/docs/gpus/link in the partial does not render on the live site.Separately,
volumes/overview.html.markerbdoes not mention that the API places a five-minute capacity hold on the hinted CPU and memory when a volume is created (rolled out April 2026). That is a real gap, but it is new feature documentation rather than GPU cleanup, so it is not in this PR.