Skip to content

filebase/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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 58.2%
  • HTML 20.2%
  • CSS 15.0%
  • JavaScript 6.6%