vessel
vessel copied to clipboard
improve install instructions
The README currently states:
- Download a copy of the vessel binary from the release page or build one yourself
- Run vessel init in your project root.
There are a lot of steps missing in between 1 and 2. What do I do with the binary once I've downloaded it? Etc.
On macOS I had to chmod +x
it, try to run it via ./vessel-macos
, open System Preferences > Security & Privacy and allow it to run, then I had to move it somewhere to it's in my path (I chose /usr/local/bin
based on this answer on StackExchange).
Issue #35 in here references a vessel-install.sh
script, but I don't see that anywhere in this repo.
@electrovir I think if it was a pkg file, it would be less harmful to newbies.
I tried these steps.
- download the binary : "vessel-macos".
- move it to "/usr/local".
- run
chmod +x /usr/local/vessel-macos
. - add
export PATH=$PATH:/usr/local/vessel-macos
&alias vessel='vessel-macos'
to~/.zshrc
. - run
source ~/.zshrc
.
I've been able to use vessel
in CLI, but I got this error when ran dfx.json's "packtool": "vessel sources"
.
Building canisters...
The build step failed for canister 'ryjl3-tyaaa-aaaaa-aaaba-cai' with an embedded error: Failed to invoke the package tool "./vessel" "sources"
the error was: No such file or directory (os error 2)
Hi I ran into this problem myself. Yes, this is a barrier. I found it this way, maybe it will be useful to someone. This is a problem with aliases in the Operating system. In dfx.json
"defaults": {
"build": {
"args": "",
"packtool": "vessel-linux64 sources"
}
},
"vessel-linux64 sources"
This should work, just move it to /usr/local/bin/vessel
.
/usr/local/bin
is already on the path, so no alias needed.
The exact steps:
# download the binary : "vessel-macos".
# Move it to /usr/local/bin/vessel
mv ~/Downloads/vessel-macos /usr/local/bin/vessel
# make it executable
chmod +x /usr/local/bin/vessel
# Test it.
$ vessel --version
# The first time you run it, it will be blocked, but you can unblock it...
# > Apple menu > System Preferences, click Security & Privacy , then click General.
# (-) If the lock at the bottom left is locked , click it to unlock the preference pane.
# (-) Click on `open it anyways...`
vessel --version
worked for me! Thanks.
Closing since the readme now contains more detailed installation instructions.