Manual Installation Instructions

Mac/Linux Installation

If you cannot / wish not to use the shell script to install for Linux or OSX, you can alternatively install dpm manually by running this set of commands in your terminal:

The latest stable release version can be found by hitting the following URL:

VERSION="$(curl -sS "https://get.digitalasset.com/install/latest")"

And you can then use this to retrieve the tarball of the full installation, extract, and install, as outlined in the full instructions below.

Manual installation for Mac/Linux
# get latest version number
VERSION="$(curl -sS "https://get.digitalasset.com/install/latest")"

# set your architecture to either amd64 | arm64
ARCH="$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')"

# set your OS to either darwin or linux
OS="$(uname | tr '[:upper:]' '[:lower:]')"

# pull down appropriate tarball for your OS and architecture
readonly TARBALL="dpm-${VERSION}-${OS}-${ARCH}.tar.gz"

# determine location of tarball to download
TARBALL_URL="https://get.digitalasset.com/install/dpm-sdk/${TARBALL}"

# make tmpdir
TMPDIR="$(mktemp -d)"

# download tarball
curl -SLf "${TARBALL_URL}" --output "${TMPDIR}/${TARBALL}" --progress-bar "$@"

# create directory to extract into
extracted="${TMPDIR}/extracted"
mkdir -p "${extracted}"

# untar to extracted directory
tar xzf "${TMPDIR}/${TARBALL}" -C "${extracted}" --strip-components 1

# bootstrap dpm
"${extracted}/bin/dpm" bootstrap "${extracted}"

# verify dpm version runs and does not return an error
if ! "${extracted}/bin/dpm" version; then
  echo "dpm version failed" >&2
  exit 1
fi

# cleanup tmpdir
rm -rf "${TMPDIR}"

Windows Installation

Download and unpack the windows dpm-sdk archive (.zip), then:

Manual installation script for Windows
 1# Extract the downloaded zip ($ZIP_PATH) to temp directory ($EXTRACTED)
 2# Avoid using the system's temp directory as the user may not have rights to it
 3New-Item -ItemType Directory -Path $EXTRACTED | Out-Null
 4Expand-Archive -Path $ZIP_PATH -DestinationPath $EXTRACTED
 5
 6# Optionally, override the TMP and DPM_HOME environment variable to point to directories other than the default,
 7# as the user might not have rights to the default directories.
 8# (You might also want to persist these variables as DPM uses them on every invocation)
 9$env:TMP = "<user-owned temporary directory>"
10$env:DPM_HOME = "<user-owned directory>"
11
12& "$EXTRACTED\windows-amd64\bin\dpm.exe" bootstrap $EXTRACTED\windows-amd64

Unstable Version Manual Installation

Preview / unstable versions are also available for experimentation, though it is always recommended to use the stable versions listed above instead.

Unstable Mac / Linux

Follow the Mac/Linux Installation instructions to install an unstable version, but note the differences in VERSION and TARBALL_URL.

The latest unstable release version can be found by hitting the following URL:

VERSION="$(curl -sS "https://get.digitalasset.com/unstable/install/latest")"

The unstable tarball can be retrieved from the following URL:

# determine location of tarball to download
TARBALL_URL="https://get.digitalasset.com/unstable/install/dpm-sdk/${TARBALL}"

Unstable Windows

Download and unpack the latest windows unstable dpm-sdk archive (.zip), then follow Windows Installation instructions.