cli

Upsun CLI

The Upsun CLI is the official command-line interface for Upsun (formerly Platform.sh).

This repository hosts the source code and releases of the CLI.

This product includes PHP software, freely available from the PHP website

Install

To install the CLI, use either Homebrew (on Linux, macOS, or the Windows Subsystem for Linux) or Scoop (on Windows):

HomeBrew

brew install platformsh/tap/platformsh-cli

If you have issues with missing libraries on a Mac, see how to troubleshoot CLI installation on M1/M2 Macs.

Scoop

scoop bucket add platformsh https://github.com/platformsh/homebrew-tap.git
scoop install platform

Bash installer

Use the bash installer for an automated installation, using the most preferable way for your system.

curl -fsSL https://raw.githubusercontent.com/platformsh/cli/main/installer.sh | bash

The installer is configurable using the following environment variables:

• INSTALL_LOG - the install log file
• INSTALL_METHOD - force a specific installation method, possible values are brew and raw
• INSTALL_DIR - the installation directory for the raw installation method, for example you can use INSTALL_DIR=$HOME/.local/bin for a single user installation
• VERSION - the version of the CLI to install, if you need a version other than the latest one

Nix profile

Refer to the Nix documentation if you are not on NixOS.

nix profile install nixpkgs#platformsh
nix profile install nixpkgs#upsun

Installation configuration examples

curl -fsSL https://raw.githubusercontent.com/platformsh/cli/main/installer.sh | INSTALL_METHOD=raw bash

curl -fsSL https://raw.githubusercontent.com/platformsh/cli/main/installer.sh | VERSION=4.0.1 bash

curl -fsSL https://raw.githubusercontent.com/platformsh/cli/main/installer.sh | INSTALL_METHOD=raw INSTALL_DIR=$HOME/.local/bin bash

Alpine

sudo apk add --no-cache bash
curl -1sLf \
  'https://dl.cloudsmith.io/public/platformsh/cli/setup.alpine.sh' \
  | sudo -E bash

apk add --no-cache curl
curl -1sLf 'https://dl.cloudsmith.io/public/platformsh/cli/rsa.4F1C2AC5106DA770.key' > /etc/apk/keys/[email protected]
curl -1sLf "https://dl.cloudsmith.io/public/platformsh/cli/config.alpine.txt" >> /etc/apk/repositories
apk update

# Install the CLI
apk add platformsh-cli

Ubuntu/Debian

apt-get update
apt-get install -y apt-transport-https curl
curl -1sLf \
  'https://dl.cloudsmith.io/public/platformsh/cli/setup.deb.sh' \
  | sudo -E bash

apt-get update

# Only needed for Debian
apt-get install -y debian-keyring debian-archive-keyring

apt-get install -y apt-transport-https curl gnupg
curl -1sLf 'https://dl.cloudsmith.io/public/platformsh/cli/gpg.6ED8A90E60ABD941.key' |  gpg --dearmor >> /usr/share/keyrings/platformsh-cli-archive-keyring.gpg
# If you use an Ubuntu derivative distro, such as Linux Mint, you may need to use UBUNTU_CODENAME instead of VERSION_CODENAME below.
curl -1sLf "https://dl.cloudsmith.io/public/platformsh/cli/config.deb.txt?distro=$(. /etc/os-release && echo "$ID")&codename=$(. /etc/os-release && echo "$VERSION_CODENAME")" > /etc/apt/sources.list.d/platformsh-cli.list
apt-get update

# Install the CLI
apt-get install -y platformsh-cli

CentOS/RHEL/Fedora

curl -1sLf \
  'https://dl.cloudsmith.io/public/platformsh/cli/setup.rpm.sh' \
  | sudo -E bash

# Install the CLI
yum install -y platformsh-cli

Manual installation

For manual installation, you can also download the latest binaries.

Upgrade

Upgrade using the same tool:

HomeBrew

brew update && brew upgrade platformsh/tap/platformsh-cli

Scoop

scoop update platform

Bash installer

curl -fsSL https://raw.githubusercontent.com/platformsh/cli/main/installer.sh | bash

Alpine

apk add -l platformsh-cli

Ubuntu/Debian

apt-get upgrade platformsh-cli

CentOS/RHEL/Fedora

yum upgrade -y platformsh-cli

Under the hood

Building binaries, snapshots and releases

Build a single binary

make single

Build a snapshot

make snapshot

Build a snapshot for a vendor

# Download the config file at internal/config/embedded-config.yaml
make vendor-snapshot VENDOR_NAME='Upsun staging' VENDOR_BINARY='upsunstg'

Create a release

# First, create a new tag, if not already on a Git tag
git tag -f -m 'Release v5.0.0' '5.0.0'

# Create a release
# Expose a GITHUB_TOKEN to use for the release
make release

# Create a release for a vendor with the default .gorelease.vendor.yaml.tpl
# Download the config file at internal/config/embedded-config.yaml
# Optionally, download the .goreleaser.vendor.yaml file to use a custom one
make vendor-release VENDOR_NAME='Upsun staging' VENDOR_BINARY='upsunstg'

Licenses

This binary redistributes PHP in a binary form, which comes with the PHP License.