The Juju client is a single binary executable that is published and supported on multiple operating systems and CPU architectures. Below you will find instructions for how to install it on your preferred operating system.
- Install Juju on Linux
- Install Juju on macOS
- Install Juju on Windows
- Build Juju from source
- Next steps
Installing the Juju client from
snap is the recommended installation method, as it ensures that the client gets automatically updated as soon as a new Juju release becomes available.
Snap command not available on your system? Visit snapcraft.io for instructions on how to install
To install the latest stable version of the Juju client:
sudo snap install juju --classic
snap also allows you to select a particular version by specifying the
sudo snap install juju --classic --channel=<version/release>
A list of the available channels for the client can be obtained by running:
snap info juju
This method allows you to install the Juju client on systems that do not support snaps.
- Visit the project’s downloads page and select the binary that matches your system’s architecture and the version that you want to install.
For example, to download the 2.9.0 client for amd64:
curl -LO https://launchpad.net/juju/2.9/2.9.0/+download/juju-2.9.0-linux-amd64.tar.xz
- Validate the downloaded binary archive (optional)
Download the md5 checksum that matches the binary you just downloaded:
The link to the md5 signature can be constructed by simply appending
/+md5 to the end of the link you just downloaded.
curl -L https://launchpad.net/juju/2.9/2.9.0/+download/juju-2.9.0-linux-amd64.tar.xz/+md5 -o juju.md5
Validate the downloaded binary archive against the checksum file:
cat juju.md5 | md5sum --check
If the checksum check succeeds, the output will be:
If the check fails, md5sum exits with nonzero status and prints output similar to:
juju-2.9.0-linux-amd64.tar.xz: FAILED md5sum: WARNING: 1 computed checksum did NOT match
- Unpack and install client binary
tar xf juju-2.9.0-linux-amd64.tar.xz sudo install -o root -g root -m 0755 juju /usr/local/bin/juju
- Test that the version of the client you installed is up to date
The Juju client is available on Homebrew and can be installed as follows:
brew install juju
Visit the project’s downloads page and select the signed installer for the Juju version you wish to install.
Each Juju release is accompanied by a set of release notes that highlight the changes and bug fixes for each release. They are available on our Roadmap & Releases page.
The Juju client can be extended with plugins. See more on our Plugins page.