Download/upgrade Codefresh CLI
You need the Codefresh CLI to install Codefresh runtimes. For the initial download, you also need to generate the API key and create the API authentication context, all from the UI.
If upgrades are needed, the CLI notifies you through a banner, and you can use the existing API credentials.
Download Codefresh CLI
Downloading the Codefresh CLI requires you to select the download mode and OS, generate an API key, and authentication context.
- Do one of the following:
- For first-time installation, go to the Welcome page, select + Install Runtime.
- If you have provisioned a hybrid/hosted runtime, in the Codefresh UI, go to Runtimes, and select + Add Runtime.
- Download the Codefresh CLI:
- Select one of the methods.
- Generate the API key and create the authentication context.
Upgrade Codefresh CLI
The Codefresh CLI automatically self-checks its version, and if a newer version is available, prints a banner with the notification.
You can upgrade to a specific version if you so require, or download the latest version to an output folder to upgrade at your convenience.
- Do any of the following:
- To upgrade to the latest version, run:
cf upgrade
- To upgrade to a specific version, even an older version, run:
cf upgrade --version v<version-number>
where:
<version-number>
is the version you want to upgrade to. - To download the latest version to an output file, run:
cf upgrade --version v<version-number> -o <output-file>
where:
<output-file>
is the path to the destination file, for example,/cli-download
.
- To upgrade to the latest version, run:
Related articles
Set up hosted (Hosted GitOps) environment
Install hybrid runtimes