Upgrading azk

  1. Upgrading from azk >= 0.6.0
  2. Upgrading from azk <= 0.5.1

Upgrading from azk >= 0.6.0

Once azk has been installed via packages the upgrade process becomes really simple:

Express upgrade

# recommended for Mac users
$ curl -sSL http://azk.io/install.sh | sh

# or

# recommended for Linux users
$ wget -nv http://azk.io/install.sh -O- -t 2 -T 10 | sh

Mac OS X

$ azk agent stop
$ brew update
$ brew upgrade azukiapp/azk/azk



$ azk agent stop
$ sudo apt-get update
$ sudo apt-get install azk


$ azk agent stop
$ sudo yum upgrade azk

Upgrading from azk <= 0.5.1

For users who tested and used azk in versions prior to0.6.0, the upgrade process is not simple because of the incompatibility of the previous installation model with the installation package.

Before starting a new installation of azk you need to follow a few removal steps for previous versions:

  1. Warning: azk 0.6.0 has no backward compatibility. Persistent files, such as database information and installation of dependencies are removed, so go through the following procedure for backup:

    $ azk agent stop
    $ cp -Rf ~/.azk/data [path_to_backup]
  2. For projects that were already using azk, you need to make an adjustment in Azkfile.js. Basically replace persistent_folders and mounts_folders for the new option mounts, like the following example:

    Before version 0.6.0:

       example: {
         // ...
         mounts_folders: { ".": "/azk/#{system.name}" },
         persistent_folders: [ "/data" ],

    After version 0.6.0: (pay attention to the key position)

       example: {
         // ...
         mounts: {
           "/azk/#{system.name}": path("."),
           "/data": persistent("data"),
  3. When you run the command start on projects that you already used azk, add the extra option --reprovision, like the following example:

    $ azk start --reprovision
  4. Now we can remove the previous installation of azk with the following commands:

    $ azk agent stop
    $ azk vm remove # mac only
    $ rm -Rf ~/.azk
    $ sudo rm /etc/resolver/azk.dev
    # and remove `~/.azk/bin` from your `$PATH`
  5. Done, now you are able to install the new version of azk: