Omnitruck API

[edit on GitHub]

The Omnitruck API can be used to download platform-appropriate versions of various Chef Software Inc products.


The URL from which these downloads can be obtained has the following syntax:<CHANNEL>/<PRODUCT>/download?p=$PLATFORM&pv=$PLATFORM_VERSION&m=$MACHINE_ARCH&v=latest&prerelease=false&nightlies=false


where the difference between these URLs is the metadata and download options. Use the metadata option to verify the build before downloading it. Use the download option to download the package in a single step.


The /metadata and/or /download endpoints can be used to download packages for all products:<CHANNEL>/<PRODUCT>/download?p=$PLATFORM&pv=$PLATFORM_VERSION&m=$MACHINE_ARCH&v=latest



  • <CHANNEL> is the release channel to install from. See Chef Software Inc Packages for full details on the available channels.
  • <PRODUCT> is the Chef Software Inc product to install. A list of valid product keys can be found at
  • p is the platform. Possible values: debian, el (for CentOS), freebsd, mac_os_x, solaris2, sles, suse, ubuntu or windows.
  • pv is the platform version. Possible values depend on the platform. For example, Ubuntu: 10.10, 11.04, 11.10, 12.04, or 12.10 or for macOS: 10.6 or 10.7.
  • m is the machine architecture for the machine on which the product will be installed. Possible values depend on the platform. For example, for Ubuntu or Debian: i386 or x86_64 or for macOS: x86_64.
  • v is the version of the product to be installed. A version always takes the form x.y.z, where x, y, and z are decimal numbers that are used to represent major (x), minor (y), and patch (z) versions. One-part (x) and two-part (x.y) versions are allowed. For more information about application versioning, see Default value: latest.


Omnitruck accepts the following platforms:

Platform p m pv
Cisco IOS XR ios_xr x86_64 6
Cisco NX-OS nexus x86_64 7
Debian debian x86_64 6, 7, 8
    i386 6, 7, 8
Red Hat Enterprise Linux / CentOS el x86_64 5, 6, 7
    i386 5, 6, 7
FreeBSD freebsd x86_64 9, 10, 11
    i386 9, 10
AIX aix powerpc 6.1, 7.1
macOS mac_os_x x86_64 10.6, 10.7, 10.8, 10.9, 10.10, 10.11, 10.12
Solaris solaris2 i386 5.10, 5.11
    sparc 5.10, 5.11
Ubuntu ubuntu x86_64 10.04, 10.10, 11.04, 11.10, 12.04, 12.10, 13.04, 13.10, 14.04,``14.10``, 16.04, 16.10
    i386 10.04, 10.10, 11.04, 11.10, 12.04, 12.10, 13.04, 13.10, 14.04,``14.10`, 16.04, 16.10
Microsoft Windows windows x86_64 2016, 2012r2, 2008r2, 2003r2, 2008, 2012, 7, 8
    i386 2012r2, 2008r2, 2003r2, 2008, 2012, 7, 8


Get the Latest Build

To get the latest supported build for Ubuntu 12.04, enter the following:

to return something like:

sha1    99f26627718a3ea4464ab48f534fb24e3e3e4719
sha256  255c065a9d23f3dd0df3090206fe4d48451c7d0af0035c237bd21a7d28133f2f
version 12.9.38

Download Directly

To use cURL to download a package directly, enter the following:

$ curl -LOJ '<CHANNEL>/<PRODUCT>/download?p=debian&pv=6&m=x86_64'

To use GNU Wget to download a package directly, enter the following:

$ wget --content-disposition<CHANNEL>/<PRODUCT>/download?p=debian&pv=6&m=x86_64