Get the Latest Juju

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

Stable

The current stable version of Juju is 2.1.2.

Stable Juju is suitable for everyday production use.

On Ubuntu, the easiest way to install Juju is from a snap:

sudo snap install juju --classic

You can also install Juju using apt by adding the following PPA:

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:

CentOS:
juju-2.1.2-centos7.tar.gz(md5)
Windows:
juju-setup-2.1.2.exe(md5)
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)

Getting development releases

Current proposed version is 2.1.2, which is the same as stable (above).

Proposed releases may be promoted to stable releases after a period of evaluation. They contain bug fixes and recently stabilised features. They require evaluation from the community to verify no regressions are present. A proposed version will not be promoted to stable if a regression is reported.

To install from Ubuntu:

sudo add-apt-repository --update ppa:juju/proposed
sudo apt install juju
CentOS:
juju-2.1.2-centos7.tar.gz(md5)
Windows:
juju-setup-2.1.2.exe(md5)
macOS:
juju-2.1.2-osx.tar.gz(md5)

If you wish to test applications deployed to mixed OSes and architectures, you can pass "--config agent-stream=proposed" to the bootstrap command:

juju bootstrap cloud/region my-controller --config agent-stream=proposed

Development

Current development version is 2.2-beta3.

Development releases provide new features that are being stabilised. These releases are not suitable for production environments. Upgrading from stable releases to development releases is not supported. You can upgrade test environments to development releases to test new features and fixes.

On Ubuntu, the easiest way to install the development release of Juju is from a snap:

sudo snap install juju --beta --classic

You can also install the development release using apt by adding the following PPA:

sudo add-apt-repository --update ppa:juju/devel
sudo apt install juju
CentOS:
juju-core_2.2-beta3-centos7.tar.gz (md5)
Windows:
juju-setup-2.2-beta3.exe (md5)
macOS:
juju-core_2.2-beta3-osx.tar.gz (md5)

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 --devel juju