Skip to content

ipfs/public-gateway-checker

Repository files navigation

IPFS Public Gateway Checker

A site displaying public IPFS gateways and their online/offline status.

View the Public Gateway Checker in action

Screenshot of Public Gateway Checker

SECURITY NOTES

  • For complex websites and apps, only use gateways with ✅ in the Origin column. Gateways marked ⚠️ lack origin isolation: all sites share localStorage, cookies, and session data. Learn more.
  • For wallets and dapps, self-host your gateway on your local machine using IPFS Desktop or Kubo.
  • No central authority governs this list. IPFS Foundation operates only: ipfs.io, dweb.link, and trustless-gateway.link.

Adding a new public gateway

Regular gateways

Edit ./gateways.json:

  1. Add the gateway's address to the top of the list
  2. If you care about security of websites loaded via your gateway, make sure it is set up as a subdomain gateway. See config docs and recipes for Kubo, and learn more here.

Tor onion gateways

Edit ./onion-gateways.json:

  1. Add the .onion gateway address to the list
  2. Note: these gateways are only testable via Tor Browser

Then, submit a pull request for this change. Be sure to follow all the directions in the pull request template so your PR can be triaged as quickly as possible.

Testing locally

npm ci
npm run build
npm start

Then open http://localhost:3000/

Testing in Tor Browser: To access localhost:3000, go to about:config and set:

  • network.proxy.allow_hijacking_localhost = true
  • network.proxy.no_proxies_on = localhost, 127.0.0.1

Remember to reset these settings after testing.

About

Checks which public gateways are online or not

Topics

Resources

License

Unknown and 2 other licenses found

Licenses found

Unknown
LICENSE
Unknown
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Packages

No packages published

Contributors 115