vessel icon indicating copy to clipboard operation
vessel copied to clipboard

improve install instructions

Open electrovir opened this issue 2 years ago • 5 comments

The README currently states:

  1. Download a copy of the vessel binary from the release page or build one yourself
  2. 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 avatar Oct 19 '21 11:10 electrovir

@electrovir I think if it was a pkg file, it would be less harmful to newbies.

nnsdaos avatar Dec 01 '21 05:12 nnsdaos

I tried these steps.

  1. download the binary : "vessel-macos".
  2. move it to "/usr/local".
  3. run chmod +x /usr/local/vessel-macos.
  4. add export PATH=$PATH:/usr/local/vessel-macos & alias vessel='vessel-macos' to ~/.zshrc.
  5. 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)

ClankPan avatar Dec 31 '21 01:12 ClankPan

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"

fury02 avatar Jan 31 '22 10:01 fury02

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...`

ArjaanBuijk avatar Aug 14 '22 10:08 ArjaanBuijk

vessel --version

worked for me! Thanks.

emenylouu avatar Aug 25 '22 15:08 emenylouu

Closing since the readme now contains more detailed installation instructions.

rvanasa avatar Feb 08 '23 22:02 rvanasa