Install Clever Tools

Clever Cloud CLI is based on Node.js. We thought it to be easily available on any platform. Thus, you can download Clever Tools as a npm package, but also through package managers or as a binary on many systems:

• GNU/Linux
  • Arch Linux (AUR)
  • CentOS/Fedora (.rpm)
  • Debian/Ubuntu (.deb)
  • Exherbo
  • Other distributions (.tar.gz)
• macOS
  • Homebrew
  • Binary (.tar.gz)
• Windows
  • Winget
  • Chocolatey
  • Binary (.zip)
• Docker
  • Dockerfile
• Nix package manager
• Enabling autocompletion

GNU/Linux

Arch Linux (AUR)

If you use Arch Linux, install packages from AUR. If you don’t know how to use this, run:

git clone https://aur.archlinux.org/clever-tools-bin.git clever-tools
cd clever-tools
makepkg -si

CentOS/Fedora (.rpm)

If you use a GNU/Linux distribution that uses .rpm packages like CentOS or Fedora, run:

curl -s https://clever-tools.clever-cloud.com/repos/cc-nexus-rpm.repo > /etc/yum.repos.d/cc-nexus-rpm.repo
yum update
yum install clever-tools

Debian/Ubuntu (.deb)

If you use a GNU/Linux distribution that uses .deb packages like Debian or Ubuntu, run:

curl -fsSL https://clever-tools.clever-cloud.com/gpg/cc-nexus-deb.public.gpg.key | gpg --dearmor -o /usr/share/keyrings/cc-nexus-deb.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/cc-nexus-deb.gpg] https://nexus.clever-cloud.com/repository/deb stable main" | tee -a /etc/apt/sources.list
apt update
apt install clever-tools

Exherbo

If you are using Exherbo, run:

cave resolve repository/CleverCloud -zx1
cave resolve clever-tools-bin -zx

Other distributions (.tar.gz)

If you use another GNU/Linux distribution, download the .tar.gz archive and extract the binary in your PATH:

curl -O https://clever-tools.clever-cloud.com/releases/latest/clever-tools-latest_linux.tar.gz
tar xvzf clever-tools-latest_linux.tar.gz
cp clever-tools-latest_linux/clever ~/.local/bin/

macOS

Homebrew

If you use macOS and you have Homebrew installed, run:

brew install CleverCloud/homebrew-tap/clever-tools

Binary (.tar.gz)

If you use macOS, but you don’t have Homebrew installed, download the .tar.gz archive and extract the binary in your PATH:

curl -O https://clever-tools.clever-cloud.com/releases/latest/clever-tools-latest_macos.tar.gz
tar xvzf clever-tools-latest_macos.tar.gz
cp clever-tools-latest_macos/clever ~/.local/bin/

Windows

Winget

If you use Windows run in a terminal:

winget install CleverTools

Chocolatey

If you prefer to use Chocolatey, run:

choco sources add -n=clevercloud -s='https://nexus.clever-cloud.com/repository/nupkg/'
choco feature disable --name='usePackageRepositoryOptimizations'
choco install clever-tools

We need to disable usePackageRepositoryOptimizations feature because of an incompatibility between Chocolatey and Nexus.

Binary (.zip)

You can also download the .zip archive and extract the binary in your PATH:

Invoke-WebRequest https://clever-tools.clever-cloud.com/releases/latest/clever-tools-latest_win.zip -OutFile clever-tools-latest_win.zip
Expand-Archive .\clever-tools-latest_win.zip -DestinationPath .
$env:PATH += ";$(Resolve-Path .\clever-tools-latest_win\)"

Docker

If you are using docker, use the image provided here.

docker pull clevercloud/clever-tools
docker run --rm clever-tools <command>

Dockerfile

In your Dockerfile copy clever-tools from the image itself with a simple one liner:

COPY --from=clevercloud/clever-tools /bin/clever /usr/local/bin/clever

Nix package manager

If you are using Nix on NixOS or any other compatible system, the package is available in both stable and unstable channels. Follow these instructions.

Enabling autocompletion

The clever-tools CLI comes with a comprehensive auto-completion system. Some installation methods through package managers will try to enable it automatically. If not, use this for bash:

clever --bash-autocomplete-script $(which clever) | sudo tee /usr/share/bash-completion/completions/clever

or that for zsh:

clever --zsh-autocomplete-script $(which clever) | sudo tee /usr/share/zsh/site-functions