Skip to main content

​
Install

  brew install platformsh/tap/upsun-cli
If you are using Scoop, you must have the Extras bucket already installed before installing the Upsun CLI.

​
Authenticate

To list and manage your projects, authenticate by running the following command: 
upsun
This process opens a browser tab for you to log in. It also creates certificates on your computer for SSH. Once you are logged in, a list of your projects appears, along with some tips for getting started. If you experience authentication issues or want to force a login, run the command upsun login. For CI/CD pipelines and automation, use API tokens instead.

​
Update the CLI

To update to the latest version, use the same tool as for installation: 
  brew upgrade upsun-cli

​
Upgrade from the legacy CLI

To upgrade from the legacy CLI, follow the installation instructions above. Once you’ve installed the latest version, the CLI guides you through removing the installed legacy CLI.
Last modified on March 12, 2026