Installing Juju


#1

Stable versions of Juju are available on Ubuntu, various other Linux distributions, macOS, and Windows. Development releases are also available for testing.

Version 2.6.6

The most recent stable version of Juju is 2.6.6. This is the version we recommend for production use. See the Release Notes.

Ubuntu

The recommended way to install Juju is with a snap. Nevertheless, installing Juju via a PPA is still supported and is mentioned lower down.

As a snap

Juju can be installed with the following command:

sudo snap install juju --classic

This will track the stable snap channel. Other channels are available, as described on Juju’s snapcraft page.

If you’re using Ubuntu 14.04 LTS (Trusty Tahr), then you will need to install snapd before installing Juju. To do this, execute sudo apt install snapd and then reboot your computer.

Rebooting is necessary as a your computer’s Linux kernel will be updated to the 4.4.0 series.

Using a PPA

To install the most recent stable version using a PPA:

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

CentOS and other Linuxes

Juju can be installed on various Linux distributions via snaps. On Ubuntu snapd comes pre-installed but if you’re running something else you’ll need to visit Install snapd to get started.

You can now install Juju with:

sudo snap install juju --classic

In the advent that option --classic is not supported on your chosen distro, use the --devmode option.

For CentOS, download Juju and install it manually: juju-2.6.6-centos7.tar.gz (md5)

macOS

Install Juju on macOS with Homebrew. Simply enter the following into a terminal:

brew install juju

And upgrade Juju with the following:

brew upgrade juju

Windows

For Windows, an installer is available: juju-setup-2.6.6-signed.exe (md5)

Development releases

Development releases (alpha, beta, rc) are regularly published and we encourage users to test these versions with real workloads and use cases. We kindly ask you to file a bug when encountering an issue. Feedback on usability and missing functionality is also very important to us.

Using snaps

See above for how to get started with snaps if you’re running a non-Ubuntu Linux distro.

To install a development release using snaps, instead of the ‘stable’ channel, use the ‘beta’ channel:

sudo snap install juju --beta --classic

For a cutting edge experience choose the ‘edge’ channel:

sudo snap install juju --edge --classic

To upgrade or downgrade, use the refresh command with a suitable channel.
Below we install ‘edge’ and then downgrade to ‘beta’:

sudo snap install juju --edge --classic
sudo snap refresh juju --beta

Using a PPA

To install the development version using a PPA:

sudo add-apt-repository -yu ppa:juju/devel
sudo apt install juju

The alpha builds are only available with snaps (via the ‘edge’ channel).

Installing multiple Juju series

Some environments may see the need to run both the 1.x and the 2.x series of Juju concurrently. See page Running multiple versions of Juju for guidance.

Other platforms

All development release binaries are published on Launchpad. Note that leading edge builds are only available with snaps (via the ‘edge’ channel).

Juju plugins

Juju functionality can be extended through the use of plugins. See the Juju plugins page for information.

Building from source

Refer to the Contributing documentation in the codebase for instructions on how to build Juju from source.


2.4.5 Release Notes
Running multiple versions of Juju
Using the aws-integrator charm - tutorial
Basic client usage - tutorial
Create a Google Compute Engine controller
2.5.1 Release Notes
2.5.0 Release Notes
2.4.7 Release Notes
2.4.6 Release Notes
2.4.4 Release Notes
2.4.3 Release Notes
2.4.2 Release Notes
2.4.1 Release Notes
Juju documentation
Reference documents
Juju support for CentOS7
Getting started with Juju
Client
[Tutorial] Managing credentials
[Tutorial] Multi-cloud controller with GKE and auto-configured storage
[Tutorial] Installing Kubernetes with CDK and using auto-configured storage
[Tutorial] Getting started with ELK
Setting up static Kubernetes storage - tutorial
2.5.2 Release Notes
Understanding Kubernetes charms - tutorial