CLI (Command Line Interface)

The CLI is the official tool to use and manage your Platform.sh projects directly from your terminal. Anything you can do within the Web Interface can be done with the CLI. Behinds the scenes it uses both the Git interface and our REST API.

The source code of the CLI is hosted on GitHub.

Find detailed information on setting up a local development environment.

Installation

You can install the CLI easily using this command:

curl -sS https://platform.sh/cli/installer | php

You can find the system requirements and more information in the installation instructions on GitHub.

Authentication

The Platform.sh CLI will authenticate you with Platform.sh and show your projects. Just type this command to start:

platform

The credentials you enter are the same as your Platform.sh account.

note If you have created your account using the OAuth Login (via Bitbucket, GitHub or Google) then in order to use the Platform CLI you will need to create a password, which you can do using the 'Request new password' tool

Enter your details. A list of your projects appears, along with some tips for getting started.

Your command-line tools are now ready to use with Platform.sh.

Usage

The CLI uses Platform.sh API to trigger commands (Branch, Merge...) on your projects.

It's also very useful when you work locally since it can simulate a local build of your codebase as if you were pushing a change to Platform.sh.

Once you have the CLI installed, run platform list to see all of the available commands.

You can preface any command with help to see more information on how to use that command.

$ platform help domain:add
Command: domain:add
Description: Add a new domain to the project

Usage:
 domain:add [--project[="..."]] [--cert="..."] [--key="..."] [--chain="..."] [name]

Arguments:
 name                  The name of the domain

Options:
 --project             The project ID
 --cert                The path to the certificate file for this domain.
 --key                 The path to the private key file for the provided certificate.
 --chain               The path to the certificate chain file or files for the provided certificate. (multiple values allowed)
 --help (-h)           Display this help message
 --quiet (-q)          Do not output any message
 --verbose (-v|vv|vvv) Increase the verbosity of messages
 --version (-V)        Display this application version
 --yes (-y)            Answer "yes" to all prompts
 --no (-n)             Answer "no" to all prompts
 --shell (-s)          Launch the shell

Installing the CLI on Windows 10

There are multiple ways to install the CLI on Windows 10. Platform.sh recommends using Bash for Windows (Windows Subsystem for Linux).

Installing Bash for Windows

You can install Bash to use the CLI on a Windows 10, 64-bit machine. The Windows 10 Anniversary Update is needed to support Git.

To install Bash on Windows 10 Anniversary Edition you need to:

  1. Activate the Developer Mode in "Update & Security" in Windows Settings. This will prompt you to restart your computer.
  2. Activate the "Windows Subsystem for Linux (Beta)", under "Turn Windows features on or off" in the Programs and Features section of the Control Panel. Once again, you will need to restart your computer.
  3. In the Start Menu, search for the program "bash.exe", which will prompt you to install it from the Windows Store.

Bash is now installed.

You can read more on WindowsCentral.

Upon starting Bash, you will be asked to choose a username. According to the article, it doesn't have to be the same as your current username. However, if the username don't exist, the Linux system might not be able to create the Linux directory (depending on your permissions level). It is therefore recommended you use the same username for Linux as your Windows machine (provided your Windows user name isn't "Admin", as that will not be allowed).

Once Bash for Windows is installed, you can install the Platform.sh CLI with the same command as above:

curl -sS https://platform.sh/cli/installer | php