Deploy on Clever Cloud and control you applications, add-ons, services from command line.

Clever Tools are availables from many channels. The simpler way to install them, if you already have Node.js on your system, is through npm package manager:

npm install -g clever-tools

We also distribute binaries and packages for multiple systems and tools:

• GNU/Linux
  • Arch Linux (AUR)
  • CentOS/Fedora (.rpm)
  • Debian/Ubuntu (.deb)
  • Exherbo
  • Binary (.tar.gz)
• macOS
  • Homebrew
  • Binary (.tar.gz)
• Windows
  • Chocolatey
  • Binary (.zip)
• Docker
• Nix

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

To use clever-tools, you have to login.

clever login

It will open the Web console in your browser and reuse your existing session if you're already logged in.

clever login tries to open a browser through xdg-open on GNU/Linux systems (and in bash for windows). Make sure you have xdg-utils available as well as a default browser set, or you can copy and paste the URL displayed in the console.

clever create <name> --type <type> \
  [--region <region>] \
  [--org <organisation>] \
  [--alias <alias>]

Where type is one of:

• docker: for Docker-based applications
• go: for Go applications
• gradle: for applications launched with gradle
• haskell: for haskell applications
• jar: for applications deployed as standalone jar files
• maven: for applications launched with maven
• meteor: for Meteor applications launched with Node.js
• node: for Node.js applications
• php: for PHP applications
• play1: for Play1 applications
• play2: for Play2 applications
• python: for python27 and python3 applications
• ruby: for ruby applications
• rust: for rust applications
• sbt: for applications launched with SBT
• static-apache: for static (HTML only) websites
• war: for applications deployed as war files

Where region is one of:

• par (Paris, Clever Cloud)
• grahds (Gravelines, HDS servers, OVHcloud)
• rbx (Roubaix, OVHcloud)
• rbxhds (Roubaix, HDS servers, OVHcloud)
• scw (Paris, Scaleway DC5)
• mtl (Montreal, OVHcloud)
• sgp (Singapore, OVHcloud)
• syd (Sydney, OVHcloud)
• wsw (Warsaw, OVHcloud)

--org allows you to chose the organisation in which your app is created.

--alias allows you to deploy the same application in multiple environments on Clever Cloud (eg: production, testing, …)

clever link [--org <ORG-NAME>] <APP-NAME> [--alias <alias>]

Where APP-NAME is the name of your application, and ORG-NAME is the name of the organisation it's in. You can specify a complete application id instead of its name (in that case, --org can be omitted).

clever deploy [--alias <alias>]

--alias allows you to deploy your application several times on Clever Cloud (eg: production, testing, …)

clever status [--alias <alias>]

clever scale [--alias <alias>] [--min-flavor <minflavor>] [--max-flavor <maxflavor>] [--min-instances <mininstances>] [--max-instances <maxinstances>]

You can display help about each command with clever help.

clever help
clever help deploy

cd node_project
clever login
clever create "Node.js application" -t node -r mtl
clever deploy

Send us an email! or submit an issue.

This project uses GitHub Actions to build binaries, package them and release them automatically on the various repositories. If you want to know more or if you need to release a new version, please read RELEASE.md carefully.

This project is licensed under the Apache-2.0.

We're using a CJS bundled version of a file from curlconverter:

• The project is licensed with MIT
• The copyright is at the top the file vendors/curlconverter-parse
• The details are explained in README_VENDORS.md