Troubleshooting

⚠️ Troubleshooting

Intro

If you don't see the problem you're running into here, please post questions at https://discuss.ipfs.tech/c/help/helia/40. If you have found a bug, please open an issue.

Common issues

⏰ I'm seeing a lot of errors in my browser console when using Helia. How can we catch and handle these errors?

Unfortunately, some network transport errors cannot be caught in the browser. This is currently true for

WebSocketsSecure - (no current tracking issue) WebTransport - https://github.com/ipfs/in-web-browsers/issues/211, https://bugs.chromium.org/p/chromium/issues/detail?id=1473980 Please see https://github.com/ipfs/helia/issues/151#issuecomment-1613511585 for a more detailed explanation.

📞 I am experiencing issues retrieving content created by my Helia node. How can I make this easier?

We have spent much time debugging and troubleshooting various connectivity issues with js-libp2p and Helia documented at https://github.com/ipfs/helia/issues/182. Please follow that tracking issue for further information and updates on improvements in this space.

⚠️ I am getting ERR_REQUIRE_ESM or ERR_PACKAGE_PATH_NOT_EXPORTED errors

Helia only exports ESM, not CJS. See https://github.com/ipfs-examples/helia-examples/tree/main/examples/helia-cjs?rgh-link-date=2024-01-04T18%3A31%3A57Z#usage for help