Co-Scientist
When installing or authenticating the Seqera CLI, you might encounter the following issues.
Installation
seqera: command not found
If you see seqera: command not found after installation:
-
Verify the Seqera CLI installation location:
which seqera -
Ensure the npm global
bindirectory is on your PATH. Find it withnpm config get prefixornpm bin -g:# Check the npm global bin directory
npm bin -g
# Restart your terminal or run
source ~/.bashrc # or ~/.zshrc -
If you installed the standalone binary, verify it is in a directory on your PATH:
echo $PATH
npm permission errors
If you encounter permission errors during installation:
-
Use the npm prefix option to install to a user-writable directory:
npm install -g seqera --prefix ~/.npm-global -
Add the directory to your PATH:
export PATH="$HOME/.npm-global/bin:$PATH"
EACCES permission errors on global install
Avoid running sudo npm install. Either fix npm permissions or install Node through a version manager such as nvm.
Authentication
Browser doesn't open
If the browser doesn't open automatically:
- Check the terminal output for a URL.
- Copy and paste the URL into your browser.
- Complete authentication in the browser.
Login timeout
If authentication times out:
- Ensure you have internet connectivity.
- Check that
https://seqera.iois accessible. - Log out and log in again.
Token storage errors
If you see errors related to credential storage:
-
Check that you have write permissions to
~/.config/seqera-ai/:ls -la ~/.config/seqera-ai/ -
If the directory doesn't exist, create it:
mkdir -p ~/.config/seqera-ai
Session expired
If your session has expired, log out and log in again:
seqera logout
seqera login