Hide Sidebar

Installing Appsody

The easiest way to install Appsody is to use the installers, which are available for all supported platforms, except Windows®.


Appsody supports the following operating systems on x86 hardware:

  • macOS®
  • Ubuntu
  • Red Hat Enterprise Linux (RHEL)
  • Windows® - Windows 10 Professional and Windows 10 Enterprise editions only


To use all of Appsody's functions, you need to install Docker and start the Docker daemon on your system.

Currently, Appsody supports using a local Docker daemon only. See the FAQ.

In environments where Docker is not available, a subset of Appsody commands can be used with Buildah as detailed in the FAQ. Prerequisites specific to each operating system are provided within the links of the following section.

Using installers

Installation steps are covered in the following sections:

Appsody does not have an installer package for Windows, so to install Appsody on that operating system follow:

Alternative install methods

Appsody binaries

If you prefer not to use an installer, you can install Appsody by using a binary file. These instructions are for installing on macOS, Ubuntu, and RHEL. For Windows, follow Installing on Windows:

  1. Go to the Appsody Releases page, scroll to the release you want and download the file that is appropriate to your operating system. For example, on macOS: appsody_v.r.m-darwin-amd64.tar.gz, where v.r.m indicates the release tag.

  2. Extract the files by running:

tar -xvf appsody_v.r.m-darwin-amd64.tar.gz
  1. This is a nested zip file so if you use a GUI you might have to unzip twice.

Building Appsody from source

If you would like to build Appsody from the source code, look at Building from Source.