How to Install Deis Control Utility on CoreOS

Today, we'll learn how to install Deis Control Utility on our latest CoreOS. Deis is an open source PaaS lightweight application platform that deploys and scales Twelve-Factor apps that builds upon Docker containers across a cluster of CoreOS to provide a lightweight PaaS with a Heroku-inspired workflow. It is designed to run applications that adhere to Twelve-Factor App methodology and best practices. Deis offers support for either Dockerfile or Heroku buildpack-based specification. Deis Control Utility also known as deisctl, is a command-line client used to configure and manage the Deis Platform.

Here in this tutorial, we'll go for installing Deis Control Utility on our CoreOS.

1. Cloning Deisctl Installer

We can install deisctl (Deis Control Utility) using an automated installer coded by the developers of . We'll need to run the following commands to get the binary installed inside ~/bin directory. First, we'll create a directory bin inside our home folder, then we'll enter into the directory bin then, we'll use curl to fetch the installer script as .

$ cd ~/bin
$ curl -sSL >

2. Installing Deisctl

Now, after we have downloaded installer, we'll install deisctl using the following command. This will instal deisctl with its required stuffs into /opt/bin/ directory. We can access deisctl just simply by running deisctl into the command line.

$ sudo sh

Installing Deisctl Using Installer

Currently, the above command installs version 1.4.1 to the current directory, and downloads the matching Deis systemd unit files used to schedule the components.

3. Version of Deisctl installed

We can check the version of deisctl installed using the following command.

$ deisctl --version

Deisctl Version


4. Usages of Deisctl

We can get the usages of Deisctl using deisctl --help command with lots of flags available.

$ deisctl --help


● ▴ ■
■ ● ▴ Deis Control Utility
▴ ■ ●

Usage: deisctl [options] <command> [<args>...]

Commands, use "deisctl help <command>" to learn more:
install                install components, or the entire platform
uninstall            uninstall components
list                     list installed components
start                   start components
stop                   stop components
restart                stop, then start components
scale                 grow or shrink the number of routers, registries or store gateways
journal              print the log output of a component
config               set platform or component values
refresh-units     refresh unit files from GitHub
help                  show the help screen for a command

Here is the help option of Deisctl flags shown in the image.

Deisctl Help Options


If everything went cool, you'll have Deis Control Utility successfully installed on CoreOS. Deisctl is an important tool for setting the system up. It is used to provision the Deis platform from a CoreOS. This tutorial allows one to build and install Deisctl easily. If you have any questions, suggestions, feedback please write them in the comment box below so that we can improve or update our contents. Thank you ! Enjoy :-)

Arun Pyasi 6:00 am

About Arun Pyasi

Linux Enthusiast geek and Web Developer who loves Free and Open Source Software (FOSS). He is a FOSS activist who loves technology, hacking, blogging, travelling, research and development. He is the Founder/Lead Developer of Chitwanix OS.

Author Archive Page

Have anything to say?

Your email address will not be published. Required fields are marked *

All comments are subject to moderation.


  1. Hello
    When I am trying to install deisctl by using their shell script
    It always shows a problem: ./deisctl: 1: ./deisctl: Syntax error: "(" unexpected

    Could you please help me to fix the error.