Skip to content

Add Cloudflare 525, TLS socket, xterm-kitty and regions-vs-AZ sections - #2576

Open
alexleventer wants to merge 2 commits into
mainfrom
seo-errors-regions-1018
Open

alexleventer wants to merge 2 commits into
mainfrom
seo-errors-regions-1018

Conversation

@alexleventer

@alexleventer alexleventer commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

These four searches already reach fly.io, but they land on old community threads or on pages that don't answer the question. Search Console data is from the last 28 days (09-18 → 10-15).

  • Cloudflare error 525 (networking/understanding-cloudflare): new H3 that covers a missing cert, no healthy Machine, and intermittent resets, and warns against switching to Flexible mode. It's linked from the error-code list and the 520 entry on troubleshooting. The "error code 525" queries get 2,319 impressions at ~8 with 1 click, all going to community thread 1798.
  • "Client network socket disconnected before secure TLS connection was established" (troubleshooting → Custom domains and TLS): stale DNS after an app was recreated, a missing cert, or no healthy Machine. 467 impressions at 6.2; it currently lands on community thread 2062.
  • "Error opening terminal: xterm-kitty" (troubleshooting → Networking): fix with TERM=xterm-256color fly ssh console or install kitty-terminfo in the image. 325 impressions at 6.3; it currently lands on community thread 12256.
  • Regions vs availability zones (reference/regions): new H2 for people coming from AWS. It covers host placement for Machines and the hardware zones volumes are placed in (both as already documented), plus multi-region. "aws zones vs regions" and related queries get 1,058 impressions at 6.7–10.7 with 0 clicks.

A second commit adds five more error messages that land on community threads today:

  • "ERR_CONNECTION_CLOSED" (troubleshooting → Networking, plus the "Find your problem" list): no certificate for the hostname (Fly Proxy closes the TLS handshake), Machines being replaced during a deploy or scale, and browser state when curl or a private window works. 16,124 impressions at 10.8; it currently lands on community thread 5489.
  • "System has not been booted with systemd as init system (PID 1). Can't operate." (app-guides/multiple-processes, H2): Fly's init is PID 1 and can't be replaced, so start the program from CMD/ENTRYPOINT or use process groups or a process manager. Community thread 14416.
  • "SSL_ERROR_ACCESS_DENIED_ALERT" (networking/custom-domain → Troubleshoot certificate creation): apex and www are separate hostnames and each needs fly certs add. Community thread 3676.
  • Express trust proxy on Fly.io (networking/request-headers, H2): app.set('trust proxy', 2), why true is spoofable, Fly-Client-IP as the alternative, and that client-sent X-Forwarded-Proto/-Port/-Ssl pass through while the Fly-Forwarded-* versions don't. Checked against debug.fly.dev. Community thread 6346.
  • VS Code "Failed to set up dynamic port forwarding connection over SSH" (blueprints/opensshd, H2): the built-in SSH server doesn't support port forwarding, so run OpenSSH as the blueprint describes and point VS Code at it. Community thread 23541.

New headings have explicit IDs so the cross-links don't depend on how Mintlify generates slugs.

🤖 Generated with Claude Code

Search Console shows these queries landing on old community threads or
on pages that don't answer them:
- Cloudflare error 525 (2,319 impressions/28d, position ~8, 1 click)
- "client network socket disconnected before secure TLS connection was
  established" (467 impressions, position 6.2)
- "error opening terminal: xterm-kitty" (325 impressions, position 6.3)
- AWS zones vs regions (1,058 impressions on /reference/regions, 0 clicks)

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@mintlify

mintlify Bot commented Oct 19, 2026 •

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
fly-io 🟢 Ready View Preview Oct 19, 2026, 4:30 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

…proxy and VS Code SSH docs

Search Console shows these error queries landing on old community threads
instead of the docs:
- ERR_CONNECTION_CLOSED (16,124 impressions/28d, position 10.8, thread 5489)
- "System has not been booted with systemd as init system" (thread 14416)
- SSL_ERROR_ACCESS_DENIED_ALERT (thread 3676)
- Express trust proxy (thread 6346)
- VS Code "Failed to set up dynamic port forwarding connection" (thread 23541)

Co-Authored-By: Claude Opus 5.5 <[email protected]>

This branch was successfully deployed

1 active deployment
staging — 826448fb Deployed Oct 19, 2026 by mintlify[bot]
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.

1 participant