install-client.rst

title:	Install the Deis Client on your Workstation
description:	First steps for developers using Deis to deploy and scale applications.

Install the Client

The Deis client allows you to interact with a Deis :ref:`Controller`. You'll need to install the client before you can use Deis.

Install with Pip

Install the latest Deis client using Python's pip:

$ pip install deis
Downloading/unpacking deis
  Downloading deis-0.8.0.tar.gz
  Running setup.py egg_info for package deis
  ...
Successfully installed deis
Cleaning up...
$ deis
Usage: deis <command> [<args>...]

Integrated Help

The Deis client comes with comprehensive documentation for every command. Use deis help to explore the commands available to you:

$ deis help
The Deis command-line client issues API calls to a Deis controller.

Usage: deis <command> [<args>...]

Auth commands::

  register      register a new user with a controller
  login         login to a controller
  logout        logout from the current controller

Subcommands, use ``deis help [subcommand]`` to learn more::
...

To get help on subcommands, use deis help [subcommand]:

$ deis help apps
Valid commands for apps:

apps:create        create a new application
apps:list          list accessible applications
apps:info          view info about an application
apps:open          open the application in a browser
apps:logs          view aggregated application logs
apps:run           run a command in an ephemeral app container
apps:destroy       destroy an application

Use `deis help [command]` to learn more