FAQ

A list of potential errors you may face and their fixes

Mac Users Download Error

Majority of Mac users face a permission error when attempting to install odyssey-cli SDK. Please carry out the following troubleshooting steps.

1. Ensure that node.js is version 20

node -v

1. Use the following command to give full access to the ‘node modules’ folder that is created together with the npm package.

sudo chown -R $(whoami):staff /usr/local/lib/node_modules/

sudo chown -R $(whoami):staff /usr/local/bin

1. Use the following command to clear the cache within the entire npm package

sudo chown -R $(whoami) ~/.npm

npm cache clean --force

1. Install Homebrew and add it into your path

/bin/bash -c "$(curl -fsSL [https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh](https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))"

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

brew install pkg-config cairo pango libpng jpeg giflib librsvg

1. Continue installing odyssey as per instructions

Should you still face issues, set node.js to version 18

nvm install 18

nvm use 18

Permission denied after odyssey SDK successfully installed

Use the sudo command for elevated permissions. For example, if you face such an error during the odyssey init step

sudo odyssey init

Mint-To function returns an error

Make sure you run the mint-to function from the 'base' folder (odyssey in our example) and not any other folder. A common mistake is running this from the 'backend' folder.

End of page

---