# Vessel Installation

**URL:** <https://forum.dfinity.org/t/vessel-installation/2551>\
**Category:** Developers\
**Created:** [April 21, 2021, 12:38pm UTC](https://forum.dfinity.org/t/vessel-installation/2551 "2021-04-21T12:38:41Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![Gabriel](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/gabriel/32/546_2.png) [@Gabriel](https://forum.dfinity.org/u/Gabriel)\
**Post date:** [April 21, 2021, 12:38pm UTC](https://forum.dfinity.org/t/vessel-installation/2551/1 "2021-04-21T12:38:41Z")

</div>

Hi,

It’s been a while since I haven’t used vessel but I tried it yesterday.

So first point:  
In order to install [Releases · dfinity/vessel · GitHub](https://github.com/dfinity/vessel/releases) the only guide is this `Download a copy of the `vessel` binary [from the release page](https://github.com/dfinity/vessel/releases) or build one yourself` which is a bit poor.  
So in order to get it I had to run:

1. `wget https://github.com/dfinity/vessel/releases/download/v0.6.1/vessel-linux64`
2. `chmod +x vessel-linux64`
3. `./vessel-linux64`

Simple enough but it would be good to be in the README

Second point:  
I noticed the files from the release are not .dmg or .deb so you can’t install them. so in order to run vessel you have to keep a copy in your project root

So if you have more projects you need to keep a copy in each one of them

And the last point:  
Previously I had a `package-set.json` and a `vessel.json` but it seems that’s not working anymore and you need a `package-set.dhall` and a `vessel.dhall` now.

That’s fine but I can’t make it work so my package-set.dhall is

 ![set](https://us1.discourse-cdn.com/flex023/uploads/dfn/original/2X/f/f786766591e0932402510294141f44a705ed8fe5.png)  
and my `vessel.dhall` is

`{ dependencies = ["base", "matchers"], compiler = None Text }`  
but I get this error:

 ![err](https://us1.discourse-cdn.com/flex023/uploads/dfn/original/2X/f/ff86cd55a7adc8bac2bde9a2b264b492bc0c8a00.png)

any help is appreciated

---

<div class="post-metadata">

**Author:** ![Ori](https://avatars.discourse-cdn.com/v4/letter/o/ecae2f/32.png) [@Ori](https://forum.dfinity.org/u/Ori)\
**Post date:** [April 21, 2021, 1:20pm UTC](https://forum.dfinity.org/t/vessel-installation/2551/2 "2021-04-21T13:20:10Z")

</div>

That might be coming from the motoko-matchers package, which has a package-set.dhall itself. This will have a `let upstream = ...` line at the top where you’ll see the hash it’s checking against.

Did you run vessel init to generate the package-set.dhall for your project first? This should include an upstream entry pointing at kritzcreek’s package set repo instead, try that version and/or working your way up from there.

@kritzcreek

---

<div class="post-metadata">

**Author:** ![Gabriel](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/gabriel/32/546_2.png) [@Gabriel](https://forum.dfinity.org/u/Gabriel)\
**Post date:** [April 21, 2021, 3:58pm UTC](https://forum.dfinity.org/t/vessel-installation/2551/3 "2021-04-21T15:58:03Z")

</div>

Yeah that’s what I did, I didn’t even changed the files generated by init.  
Note: I’m on dfx `0.7.0-beta.3` so they might not be compatible yet

---

<div class="post-metadata">

**Author:** ![Gabriel](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/gabriel/32/546_2.png) [@Gabriel](https://forum.dfinity.org/u/Gabriel)\
**Post date:** [May 15, 2021, 7:39pm UTC](https://forum.dfinity.org/t/vessel-installation/2551/4 "2021-05-15T19:39:26Z")

</div>

Seems like this has been fixed with this PR [`upgrade-set` generates wrong sha256 · Issue #28 · dfinity/vessel · GitHub](https://github.com/dfinity/vessel/issues/28)  
Thanks @kritzcreek

---

<div class="post-metadata">

**Author:** ![Nuno](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/nuno/32/30138_2.png) [@Nuno](https://forum.dfinity.org/u/Nuno)\
**Post date:** [September 3, 2021, 2:49pm UTC](https://forum.dfinity.org/t/vessel-installation/2551/5 "2021-09-03T14:49:28Z")

</div>

I’ve done the 3 steps you mention on the post but getting the error `zsh: command not found: vessel` I’m on a mac. Any ideas how to fix it?

---

<div class="post-metadata">

**Author:** ![Gabriel](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/gabriel/32/546_2.png) [@Gabriel](https://forum.dfinity.org/u/Gabriel)\
**Post date:** [September 6, 2021, 2:42pm UTC](https://forum.dfinity.org/t/vessel-installation/2551/6 "2021-09-06T14:42:38Z")

</div>

what PATH did you used?

---

<div class="post-metadata">

**Author:** ![Nuno](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/nuno/32/30138_2.png) [@Nuno](https://forum.dfinity.org/u/Nuno)\
**Post date:** [September 6, 2021, 4:39pm UTC](https://forum.dfinity.org/t/vessel-installation/2551/7 "2021-09-06T16:39:34Z")

</div>

🤔 I must have used the default, which one should I use?

---

<div class="post-metadata">

**Author:** ![coin\_master](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/coin_master/32/15963_2.png) [@coin\_master](https://forum.dfinity.org/u/coin_master)\
**Post date:** [September 7, 2021, 5:16am UTC](https://forum.dfinity.org/t/vessel-installation/2551/8 "2021-09-07T05:16:51Z")

</div>

You can just add the PATH to the existing one, for example `.profile` or `.zshrc` if you are using zsh.

---

<div class="post-metadata">

**Author:** ![Gabriel](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/gabriel/32/546_2.png) [@Gabriel](https://forum.dfinity.org/u/Gabriel)\
**Post date:** [September 7, 2021, 7:42pm UTC](https://forum.dfinity.org/t/vessel-installation/2551/9 "2021-09-07T19:42:32Z")

</div>

. For linux use:`$HOME/bin`  
For osx: usr/local/bin

---

<div class="post-metadata">

**Author:** ![karim](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/karim/32/4680_2.png) [@karim](https://forum.dfinity.org/u/karim)\
**Post date:** [February 19, 2022, 11:43am UTC](https://forum.dfinity.org/t/vessel-installation/2551/10 "2022-02-19T11:43:43Z")

</div>

Let me slide into this real quick: I’m trying to deploy CAP as per this documentation: [Motoko SDK - Getting Started - Documentation | CAP](https://docs.cap.ooo/integrate-cap/motoko-sdk/)

Running the command `dfx deploy cap-motoko-example --argument "(opt \"<Router ID>\")"` I’m being prompted with `The build step failed for canister 'rrkah-fqaaa-aaaaa-aaaaq-cai' with an embedded error: Failed to invoke the package tool "vessel" "source" the error was: No such file or directory (os error 2)`.

I have downloaded the vessel-linux64 binary and I’m on Arch Linux. Running ./vessel-linux64 as @Gabriel suggests, doesn’t install the package manager as I’m used to. I don’t have any experience installing executables on Linux but usually I just type ./EXECUTABLE-NAME and it will run an install script. This is the dfx.json for CAP:

> **Zusammenfassung**
>
> ```auto
> {
> "canisters": {
> "cap-motoko-example": {
> "main": "src/main.mo",
> "type": "motoko"
> }
> },
> "defaults": {
> "build": {
> "args": "",
> "packtool": "vessel source"
> }
> },
> "dfx": "0.8.4",
> "networks": {
> "local": {
> "bind": "127.0.0.1:8000",
> "type": "ephemeral"
> }
> },
> "version": 1
> }
> 
> ```

What am I missing? Could somebody help me out please?

---

<div class="post-metadata">

**Author:** ![cryptoschindler](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/cryptoschindler/32/26_2.png) [@cryptoschindler](https://forum.dfinity.org/u/cryptoschindler)\
**Post date:** [February 20, 2022, 12:52pm UTC](https://forum.dfinity.org/t/vessel-installation/2551/11 "2022-02-20T12:52:42Z")

</div>

Maybe this helps:

Rename `vessel-linux64` to `vessel`, make sure it’s executable (`chmod +x vessel`) and move it to `usr/local/bin`.

---

<div class="post-metadata">

**Author:** ![Gabriel](https://sea1.discourse-cdn.com/flex023/user_avatar/forum.dfinity.org/gabriel/32/546_2.png) [@Gabriel](https://forum.dfinity.org/u/Gabriel)\
**Post date:** [February 20, 2022, 2:58pm UTC](https://forum.dfinity.org/t/vessel-installation/2551/12 "2022-02-20T14:58:38Z")

</div>

Yeah it’s a bit confusing, I’ve created a PR here but it hasn’t been approved:

> <https://github.com/dfinity/vessel/pull/29>
>
> I had some issues figuring out how to install vessel. So it seems the installer …has to be in $PATH and this is what worked for me on ubuntu (wsl2) and macos.

1. For Ubuntu in `$HOME/bin` RUN `wget https://github.com/dfinity/vessel/releases/download/v0.6.1/vessel-linux64` For OSX in `usr/local/bin` RUN: `wget https://github.com/dfinity/vessel/releases/download/v0.6.1/vessel-macos`
2. Rename vessel-linux64 to vessel eg: RUN `mv vessel-linux64 vessel`
3. Change permissions, `chmod +x vessel`
