Upgrade notice: If you already have azk installed, prior to the 0.6.0 release, follow these steps before moving forward. If you do not have azk installed ignore this warning and continue the installation normally.


  • Distributions (tested): Ubuntu 12.04/14.04/15.10/16.04, Fedora 20/21/22 and Arch Linux
  • Architecture: 64-bits
  • Docker 1.8.1 or later
  • Not running any services on ports 80 and 53

Important: If you are running any service on port 80 and/or 53 you must customize the configuration of azk setting the following variables AZK_BALANCER_PORT and AZK_DNS_PORT respectively, before running azk agent start.

Installing the newest Docker version

There are two ways to install Docker:

  1. Express installation:

    $ curl -sSL | sh
    # or
    $ wget -nv -O- -t 2 -T 10 | sh
  2. Manual installation:

Granting access to Docker service to your user

The docker daemon binds to a Unix socket instead of a TCP port. By default that Unix socket is owned by the user root and other users can access it with sudo. For this reason, docker daemon always runs as the root user.

To avoid having to use sudo when you use the docker command, create a Unix group called docker and add users to it. When the docker daemon starts, it makes the ownership of the Unix socket read/writable by the docker group.

Warning: The docker group is equivalent to the root user; For details on how this impacts security in your system, see Docker Daemon Attack Surface for details.

To create the docker group and add your user:

  1. Log in as a user with sudo privileges;

  2. Create the docker group and add your user

    $ sudo usermod -aG docker $(id -un)
  3. Log out and log back in

    This ensures your user is running with the correct permissions.

  4. Verify your work by running docker without sudo

    $ docker run hello-world

    If this fails with a message similar to this:

    Cannot connect to the Docker daemon. Is 'docker daemon' running on this host?

    Check that the DOCKER_HOST environment variable is not set for your shell. If it is, unset it.

Disabling dnsmasq service (Ubuntu-only)

In desktop systems running Ubuntu or one of its derivatives, there is a default dns service (dnsmasq) that conflicts with azk built-in dns service.

To solve this, it's needed to stop dnsmasq and ensure it won't be auto started after the next login. To do this, run:

  $ sudo service dnsmasq stop
  $ sudo update-rc.d -f dnsmasq remove

Installing azk

Express installation

The easiest way to install azk is to use the script below. It will identify your operating system, and if it is compatible perform all installation tasks.

# recommended for Mac users
$ curl -sSL | sh

# or

# recommended for Linux users
$ wget -nv -O- -t 2 -T 10 | sh


  1. Add the Azuki keys to your local keychain:

    $ sudo apt-key adv --keyserver \
     --recv-keys 022856F6D78159DF43B487D5C82CF0628592D2C9
  2. Add the Azuki repository to the apt sources list:

    # Ubuntu Precise (12.04)
    $ echo "deb [arch=amd64] precise main" | \
     sudo tee /etc/apt/sources.list.d/azuki.list
    # Ubuntu Trusty (14.04)
    $ echo "deb [arch=amd64] trusty main" | \
     sudo tee /etc/apt/sources.list.d/azuki.list
    # Ubuntu Wily (15.10)
    $ echo "deb [arch=amd64] wily main" | \
     sudo tee /etc/apt/sources.list.d/azuki.list
    # Ubuntu Xenial Xerus (16.04)
    $ echo "deb [arch=amd64] xenial main" | \
     sudo tee /etc/apt/sources.list.d/azuki.list
  3. Update the list of packages and install azk:

    $ sudo apt-get update
    $ sudo apt-get install azk
  4. You can start the azk agent now, but, make sure that the Docker service is running;


  1. Add the Azuki keys to your local keychain:

    $ rpm --import \
  2. Add the Azuki repository:

    $ echo "[azuki]
    " > /etc/yum.repos.d/azuki.repo
  3. Install azk and its dependencies:

    $ sudo yum install azk
  4. You can start the azk agent now, but, make sure that the Docker service is running;

Arch Linux

You'll need yaourt or some other tool to get packages from AUR. To learn how to install yaourt, check these instructions.

  1. Install azk and its dependencies:

    $ yaourt -S azk
  2. You can start the azk agent now, but, make sure that the Docker service is running;

Other distributions

Coming soon...

Getting started

Once azk is installed we can start using it.