Skip to content

docs: guide to replace public gateways with self-hosted IPFS#2285

Open
lidel wants to merge 6 commits into
mainfrom
docs/replace-public-gateways
Open

docs: guide to replace public gateways with self-hosted IPFS#2285
lidel wants to merge 6 commits into
mainfrom
docs/replace-public-gateways

Conversation

@lidel
Copy link
Copy Markdown
Member

@lidel lidel commented May 29, 2026

New how-to for non-browser clients and web apps still calling ipfs.io or dweb.link, routing each case to a drop-in replacement:

  • backend retrieve-only -> Rainbow, with trustless-only config for public hostnames
  • backend retrieve and publish -> Kubo, plus pinning services or IPFS Cluster for redundancy
  • browser JS -> @helia/verified-fetch, with self-hosted Someguy and Rainbow/Kubo to stay independent of public utilities

Linked from the IPFS Gateway sidebar group and the how-to index.


New how-to for non-browser clients and web apps still calling ipfs.io
or dweb.link, routing each case to a drop-in replacement:

- backend retrieve-only -> Rainbow, with trustless-only config for
  public hostnames
- backend retrieve and publish -> Kubo, plus pinning services or
  IPFS Cluster for redundancy
- browser JS -> @helia/verified-fetch, with self-hosted Someguy and
  Rainbow/Kubo to stay independent of public utilities

Linked from the IPFS Gateway sidebar group and the how-to index.
Comment thread docs/how-to/replace-public-gateways-with-self-hosted-ipfs.md
Comment thread docs/how-to/replace-public-gateways-with-self-hosted-ipfs.md
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 29, 2026

🚀 Build Preview on IPFS ready

Point readers from the gateway and public-utility docs to the
migration guide, and reorder it to match how readers choose a path.

- guide: lead with @helia/verified-fetch, then Rainbow, then Kubo,
  matching the "Pick your path" table order
- link the guide from public-utilities, ipfs-gateway, ipfs-in-web-apps,
  address-ipfs-on-web, and gateway-best-practices
- note verified-fetch can deserialize a trustless response client-side,
  so apps needing files still work against a trustless-only endpoint
- note RAINBOW_SUBDOMAIN_GATEWAY_DOMAINS needs localhost or a Public
  Suffix List hostname for browser origin isolation
- sidebar: place the guide before troubleshooting
Comment thread docs/concepts/ipfs-gateway.md
Comment thread docs/concepts/public-utilities.md
Comment thread docs/how-to/replace-public-gateways-with-self-hosted-ipfs.md
Comment thread docs/how-to/replace-public-gateways-with-self-hosted-ipfs.md
Comment thread docs/how-to/replace-public-gateways-with-self-hosted-ipfs.md
Comment thread docs/how-to/replace-public-gateways-with-self-hosted-ipfs.md
Comment thread docs/how-to/replace-public-gateways-with-self-hosted-ipfs.md
Comment thread docs/how-to/replace-public-gateways-with-self-hosted-ipfs.md
lidel added 4 commits May 29, 2026 16:26
Address the legitimate LanguageTool findings; the rest were false
positives on code fences, domains, and shell snippets.

- add comma after introductory "By default"
- "install steps" -> "installation steps"
Switch the reporter to check-run annotations and silence rules that
misfire on code and domains, so pushes stop stacking duplicate review
comments and addressed findings clear themselves.

- reporter github-pr-review -> github-pr-check (annotations replace per
  run, no duplicate comments, fixed findings drop on the next run)
- disable rules that fire on code fences, inline code, shell snippets,
  and domain names, on top of the action defaults
Touching ipfs-gateway.md made the link checker scan it and surfaced two
pre-existing dead links; the prose also used terms missing from the
Vale vocabulary.

- accept.txt: add hotlink, subresource, navigation, deserialize, env
- ipfs-gateway: gateway-troubleshooting.md -> troubleshooting.md
- mlc config: ignore gnu.org (valid URL, 403s the checker bot)
The vale Vocab is not enabled in .vale.ini, so accept.txt was dead
config; PLNSpelling reads pln-ignore.txt. Move the words there and
revert the accept.txt change.

- pln-ignore: deserializes, dnslinks, env, fastly, hotlinked, iostat,
  iotop, navigations, speedtest, subresource(s)
@lidel lidel marked this pull request as ready for review May 29, 2026 15:55
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