iim
v0.8.2
Published
IPFS install manager
Downloads
31
Maintainers
Readme
iim
IPFS install manager
About
Example - Use the latest version of Kubo
$ iim use kubo
✔ selected kubo version 0.24.0
✔ installed kubo 0.24.0
✔ installed binary at /Users/alan/.iim/dists/[email protected]/ipfs
✔ initialized IPFS at /Users/alan/.iim/[email protected]
✔ configured IPFS
✔ symlinked /Users/alan/.iim/dists/[email protected]/ipfs -> /Users/alan/.iim/dists/current
✔ symlinked /Users/alan/.iim/dists/[email protected]/ipfs -> /usr/local/bin/ipfs
🚀 IPFS is ready to use
$ ipfs version
kubo version: 0.24.0
Example - Use Kubo at version 0.23.0
$ iim use kubo 0.23
✔ selected kubo version 0.23.0
✔ installed kubo 0.23.0
✔ installed binary at /Users/alan/.iim/dists/[email protected]/ipfs
✔ initialized IPFS at /Users/alan/.iim/[email protected]
✔ configured IPFS
✔ symlinked /Users/alan/.iim/dists/[email protected]/ipfs -> /Users/alan/.iim/dists/current
✔ symlinked /Users/alan/.iim/dists/[email protected]/ipfs -> /usr/local/bin/ipfs
🚀 IPFS is ready to use
$ ipfs version
kubo version: 0.24.0
How does it work?
A new repo is created and used for each implementation/version combination at ~/.iim/[email protected]
, for example.
Adds a symlink at /usr/local/bin/ipfs
that points to a script that runs IPFS with IPFS_PATH
set to ~/.iim/[email protected]
.
IPFS is installed to ~/.iim/dists/[email protected]/node_modules/ipfs
or ~/.iim/dists/[email protected]/node_modules/go-ipfs-dep
for example.
Common issues
Failed to symlink
Looks like this:
$ iim use kubo
✔ selected kubo version 0.4.18
✔ installed kubo 0.4.18
✔ installed binary at /home/dave/.iim/dists/[email protected]/ipfs
✔ initialized IPFS at /home/dave/.iim/[email protected]
✔ symlinked /home/dave/.iim/dists/[email protected]/ipfs -> /home/dave/.iim/dists/current
✖ failed to symlink /home/dave/.iim/dists/[email protected]/ipfs -> /usr/local/bin/ipfs
💥 failed to link binary at /usr/local/bin/ipfs, try running sudo iim link
Don't worry! Mostly everything worked fine - you just don't have permission to write to /usr/local/bin
! Just run sudo iim link
and it'll try again to create that symlink.
Feel free to dive in! Open an issue or submit PRs.
Install
$ npm i iim
Note: Windows not yet supported!
API Docs
License
MIT © Alan Shaw
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.