Browser extension that simplifies access to IPFS resources
Table of Contents
This add-on enables everyone to access IPFS resources the way they were meant: from locally running IPFS node :-)
IPFS is a new hypermedia distribution protocol, addressed by content and identities. IPFS enables the creation of completely distributed applications. It aims to make the web faster, safer, and more open.
Learn more at ipfs.io (it is really cool, we promise!)
Automagical Detection of IPFS Resources
Requests for IPFS-like paths (
/ipns/$peerid_or_fqdn-with-dnslink) are detected on any website.
If tested path is a valid IPFS address it gets redirected and loaded from a local gateway, e.g:
IPFS API as
Your IPFS node is exposed as
window.ipfs on every webpage.
Websites can detect if
window.ipfs exists and opt-in to use it instead of creating their own
It saves system resources and battery (on mobile), avoids the overhead of peer discovery/connection, enables shared repository access and more!
Make sure to read our notes on
window.ipfs, where we explain it in-depth and provide examples on how to use it your own dapp.
Toggle IPFS Integrations
The Browser Action pop-up provides a toggle for suspending all active IPFS integrations with a single click.
IPFS Status and Context Actions
- IPFS API and Gateway status
- Add local (quick upload) or remote files (context menu) to IPFS with option to preserve filename
- Easy access to WebUI and add-on Preferences
- Toggle redirection to local gateway (automatic by default, manual mode can be enabled in Preferences)
- Additional actions for pages loaded from IPFS
- Pin/Unpin of IPFS resources (via API)
- Copy canonical IPFS address
- Copy shareable URL to resource at preferred public gateway
(some are disabled by default, use Preferences screen to enable)
- Requests made via experimental protocols are re-routed to HTTP gateway (public or custom):
- Detect domains with dnslink in DNS TXT record and load them from IPFS
- Make plaintext IPFS links clickable (demo)
- Mirror to IPFS by right click on any image or video
- Switch between External HTTP API and Embedded js-ipfs node. Read about differences at docs/node-types.
We recommend installing the stable release via your browser's add-on store.
|Firefox||Chrome / Chromium|
ipfs-companion is designed to retrieve content from a locally running IPFS daemon.
Make sure IPFS is installed on your computer.
Developers and enthusiasts can opt-in for Beta-quality channel with hand-picked Dev Builds:
It is also possible to grab the last successful build from
but these builds are not signed nor will automatically update:
.zip bundles are meant only to be manually loaded via
chrome://extensions (Chrome) or
about:debugging (Firefox) for the purpose of quick smoke-testing.
To work on the extension you need to install it from source rather than from the add on store.
npm install npm run build npm run bundle:generic # for Chrome dev # or npm run bundle:firefox # for Firefox dev (build default)
Load it into browser:
chrome://extensionsin the URL bar
- Enable "Developer mode"
- Click "Load unpacked extension..."
- Pick the directory
about:debuggingin the URL bar
- Check "Enable add-on debugging"
- Click "Load Temporary Add-on"
- Pick the file
docs/developer-notes.md for more detailed instructions
Reproducible Build in Docker
Want to ensure prebuilt bundle does not include any additional code?
Don't want to install JS dependencies such as NodeJS and yarn?
Do an isolated build inside of Docker!
Run the following command for ending up
with a built extension inside the
npm run release-build
It is an alias for running
ci:build script inside of immutable Docker image, which guarantees the same output on all platforms.
Legacy Firefox (< 53) and XUL-Compatible Browsers
1.x.x were based on currently deprecated Add-On SDK (Firefox-only).
While it is not maintained anymore, one can inspect, build and install it using codebase from legacy-sdk branch.
For historical background on the rewrite see Issue #20: Move to WebExtensions.
Feel free to join in. All welcome. Open an issue!
If you want to help in developing this extension, please see CONTRIBUTING page
The browser extension team hangs out at the #ipfs-in-web-browsers channel on Freenode.
This repository falls under the IPFS Code of Conduct.
The best place to ask your questions about IPFS in general, how it works and what you can do with it is at discuss.ipfs.io.
We are also available at the #ipfs channel, where most of IPFS community hangs out.
Questions specific to this browser companion can be asked directly at
Cross-Origin XHR are executed "twice" in Firefox
Due to CORS bug XHRs in Firefox are handled via late redirects in
Original request is cancelled after response headers are received, so there is no overhead of reading response payload twice.
For more details on this see PR #511.
Upload via Right-Click Does Not Work in Firefox
See this workaround.
Workaround for HTTP Redirect to Work with Ghostery
Ghostery is known to toy with HTTP-to-HTTPS redirect, which in some setups breaks websites utilizing public gateways. More details in #466. Until it is fixed upstream, a workaround is to whitelist affected site.
Rule to Work with NoScript with ABE Enabled
By default NoScript breaks this addon by blocking assets loaded from IPFS Gateway running on localhost.
To make it work, one needs to extend the SYSTEM Rulset and prepend it with IPFS whitelist:
# Enable IPFS redirect to LOCAL Site ^http://127.0.0.1:8080/(ipfs|ipns)* Anonymize # Prevent Internet sites from requesting LAN resources. Site LOCAL Accept from LOCAL Deny
Feel free to modify it, but get familiar with ABE rule syntax first.
The add-on itself is released under CC0: to the extent possible under law, the author has waived all copyright and related or neighboring rights to this work, effectively placing it in the public domain.