Skip to content

Rewrite Flycast blueprint to drop GPU/Ollama example#2394

Merged
kcmartin merged 10 commits into
mainfrom
rewrite-flycast-blueprint-no-gpu
May 19, 2026
Merged

Rewrite Flycast blueprint to drop GPU/Ollama example#2394
kcmartin merged 10 commits into
mainfrom
rewrite-flycast-blueprint-no-gpu

Conversation

@kcmartin
Copy link
Copy Markdown
Contributor

@kcmartin kcmartin commented Apr 29, 2026

Summary

GPU Machines are being deprecated on 2026-08-01, and the Flycast blueprint at blueprints/private-applications-flycast.html.md was built almost entirely around an Ollama-on-GPU walkthrough. The Flycast concepts themselves are GPU-independent, so this rewrites the guide rather than removing it.

  • Replaces the Ollama example with a generic private HTTP service using the public nginxdemos/hello image, so no external example repo is needed
  • Swaps the multi-step fly launch --no-deploy + fly ips allocate-v6 --private + fly deploy flow for the modern fly launch --image ... --flycast
  • Removes the YouTube embed (GPU/Ollama walkthrough), the "Running Llama 3" subsection, and the GPU-related related-reading links
  • Replaces "Fly Postgres" with "Managed Postgres" in the security note (the currently supported offering)
  • Refreshes related reading to point at the autostart blueprint, the Flycast reference, and private networking
  • Fixes a separately broken link (/docs/reference/services/#ip-addresses/docs/networking/services/#anycast-ip-addresses); the old path no longer resolves
  • Adds walkthrough to styles/config/vocabularies/fly-terms/accept.txt so Vale stops flagging it as a typo (it's already used elsewhere in the docs)

Walkthrough gotchas baked into the recipe

  • --internal-port 80 on fly launch: nginxdemos/hello listens on 80, but Fly Launch defaults to 8080
  • force_https = false in fly.toml: Flycast addresses don't have public TLS certs, so the default 301-to-HTTPS breaks the demo's plain HTTP requests
  • --vm-memory 1024 on the shell Machine: the 256MB default OOM-kills during apt install -y curl iputils-ping dnsutils

GPU Machines are deprecated as of 2026-08-01, so the Ollama walkthrough
needed to go. Reframed the guide around a generic private HTTP service
using the public nginxdemos/hello image and the modern fly launch
--flycast flag, so no external example repo is needed. Also swapped the
Fly Postgres mention for Managed Postgres and refreshed related reading
to drop the GPU/Ollama blog posts.
The link pointed at /docs/reference/services/#ip-addresses, which no
longer exists. The relevant content lives at
/docs/networking/services/#anycast-ip-addresses.
The image listens on port 80, but fly launch defaults the internal port
to 8080, which leaves the app unreachable over Flycast. Pass
--internal-port 80 explicitly and explain why.
fly launch enables force_https in [http_service] by default, which
makes the proxy redirect plain HTTP to HTTPS. Flycast addresses don't
have public TLS certs, so the redirect breaks the curl example. Add
--no-deploy to the launch step, instruct the reader to flip
force_https to false, then deploy.
The default 256MB shell Machine gets OOM-killed midway through
'apt install curl iputils-ping dnsutils'. 1GB has plenty of headroom
and avoids a confusing 'Killed' message that makes readers think the
walkthrough is broken.
@kcmartin kcmartin marked this pull request as ready for review May 18, 2026 16:50
@kcmartin kcmartin requested a review from Roadmaster May 18, 2026 16:51
Copy link
Copy Markdown
Contributor

@Roadmaster Roadmaster left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome! Thanks! One small nitpick.

Comment thread blueprints/private-applications-flycast.html.md Outdated
@kcmartin kcmartin merged commit fa1a844 into main May 19, 2026
2 checks passed
@kcmartin kcmartin deleted the rewrite-flycast-blueprint-no-gpu branch May 19, 2026 15:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants