Getting the latest Juju

Juju is available as a client on many platforms and distributions. Find your platform below and get started with Juju.

Version 2.1.2

The current stable version of Juju is 2.1.2 and is recommended for everyday production use.

Ubuntu

For Ubuntu 16.04 LTS (Xenial) the best install is to use snaps. (see the snapcraft.io site) you can install the stable release of Juju with the command:

 sudo snap install juju --classic

You can check which version of Juju you have installed with

 sudo snap list juju

And update it if necessary with:

 sudo snap refresh juju

Note: you can use the PPA for a stable deb package as well:

sudo add-apt-repository --update ppa:juju/stable
sudo apt install juju

macOS

The easiest way to install Juju on macOS is with the brew package manager. With brew installed, simply enter the following into a terminal:

   brew install juju

If you previously installed Juju with brew, the package can be updated with the following:

   brew upgrade juju
Alternatively, you can manually install Juju from the following archive:
juju-2.1.2-osx.tar.gz(md5)

Windows

A Windows installer is available for Juju.

juju-setup-2.1.2.exe(md5)

Centos and other Linuxes

Snaps enable installing the the Juju client on an array of Linux distributions. Note that the --classic flag is not supported on many of them and so you'll need to use --devmode instead.

See the span install documentation to get snapd onto your linux and then you can install Juju with:

 sudo snap install juju --classic
CentOS:
juju-2.1.2-centos7.tar.gz(md5)

Getting development releases

The Juju team regularly puts out alpha, beta, and RC releases during a development cycle. We encourage users to please test these versions out with their workloads and use cases and file bugs if you hit any issues. Remember that while in development, feedback on usability and missing functionality is very important so don't just file bugs for things that go wrong, but also for things that have an opportunity to be "more right".

Ubuntu

It is possible to install other versions, including beta releases of Juju via a snap package.

You can update to the non-stable channels of Juju releases by using the snap command.

   snap install <snap> --beta

Or you can get a daily build using the edge channel.

   snap install <snap> --edge

macOS

On macOS you can get development Juju from the brew package manager. The development releases are put under the --devel flag in brew.

   brew install --devel juju
Or you can use the binary built for macOS:
juju-core_2.2-beta4-osx.tar.gz (md5)

Windows

The latest windows .exe can be downloaded from the Juju download page https://launchpad.net/juju/+download

The latest is version 2.2-beta4 located at:
juju-setup-2.2-beta4.exe (md5)

Building from source

Check out the Contributing documentation in the codebase to walk through building Juju from source.