Skip to content

Commit 2312558

Browse files
authored
windows zip installation instructions (#39)
* windows zip installation instructions * more powershell
1 parent 70c7b3c commit 2312558

File tree

2 files changed

+61
-39
lines changed

2 files changed

+61
-39
lines changed

docs/src/public/dpm.rst

Lines changed: 2 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
.. Copyright (c) 2023 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.
1+
.. Copyright (c) 2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.
22
.. SPDX-License-Identifier: Apache-2.0
33
44
.. _dpm:
@@ -56,46 +56,9 @@ Windows Installation
5656

5757
Download and run the `windows installer <https://get.digitalasset.com/install/latest-windows.html>`_, which will install the dpm sdk and set up the PATH variable for you.
5858

59-
.. _dpm-manual-installation:
60-
6159
Manual Installation Instructions
6260
================================
63-
64-
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:
65-
66-
.. code:: shell
67-
68-
#get latest version number
69-
readonly VERSION="$(curl -sS "https://get.digitalasset.com/install/latest")"
70-
71-
# set your architecture to either amd64 | arm64
72-
readonly ARCH="$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')"
73-
74-
# set your OS to either darwin or linux
75-
readonly OS="$(uname | tr '[:upper:]' '[:lower:]')"
76-
77-
#pull down appropriate tarball for your OS and architecture
78-
readonly TARBALL="dpm-${VERSION}-${OS}-${ARCH}.tar.gz"
79-
80-
# determine location of tarball to download
81-
TARBALL_URL="https://artifactregistry.googleapis.com/download/v1/projects/da-images/locations/europe/repositories/public-generic/files/dpm-sdk:${VERSION}:${TARBALL}:download?alt=media"
82-
83-
# make tmpdir
84-
TMPDIR="$(mktemp -d)"
85-
86-
# download tarball
87-
curl -SLf "${TARBALL_URL}" --output "${TMPDIR}/${TARBALL}" --progress-bar "$@"
88-
89-
# create directory to extract into
90-
extracted="${TMPDIR}/extracted"
91-
mkdir -p "${extracted}"
92-
93-
# untar
94-
tar xzf "${TMPDIR}/${TARBALL}" -C "${extracted}" --strip-components 1
95-
96-
# bootstrap dpm
97-
"${extracted}/bin/dpm" bootstrap "${extracted}"
98-
61+
If you prefer a more manual installation process, see :ref:`here <dpm-manual-installation>`.
9962

10063
.. _dpm-manual-managing-releases:
10164

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
.. Copyright (c) 2026 Digital Asset (Switzerland) GmbH and/or its affiliates. All rights reserved.
2+
.. SPDX-License-Identifier: Apache-2.0
3+
4+
.. _dpm-manual-installation:
5+
6+
Manual Installation Instructions
7+
================================
8+
9+
Mac/Linux
10+
---------
11+
12+
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:
13+
14+
.. code:: shell
15+
16+
#get latest version number
17+
readonly VERSION="$(curl -sS "https://get.digitalasset.com/install/latest")"
18+
19+
# set your architecture to either amd64 | arm64
20+
readonly ARCH="$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')"
21+
22+
# set your OS to either darwin or linux
23+
readonly OS="$(uname | tr '[:upper:]' '[:lower:]')"
24+
25+
#pull down appropriate tarball for your OS and architecture
26+
readonly TARBALL="dpm-${VERSION}-${OS}-${ARCH}.tar.gz"
27+
28+
# determine location of tarball to download
29+
TARBALL_URL="https://artifactregistry.googleapis.com/download/v1/projects/da-images/locations/europe/repositories/public-generic/files/dpm-sdk:${VERSION}:${TARBALL}:download?alt=media"
30+
31+
# make tmpdir
32+
TMPDIR="$(mktemp -d)"
33+
34+
# download tarball
35+
curl -SLf "${TARBALL_URL}" --output "${TMPDIR}/${TARBALL}" --progress-bar "$@"
36+
37+
# create directory to extract into
38+
extracted="${TMPDIR}/extracted"
39+
mkdir -p "${extracted}"
40+
41+
# untar
42+
tar xzf "${TMPDIR}/${TARBALL}" -C "${extracted}" --strip-components 1
43+
44+
# bootstrap dpm
45+
"${extracted}/bin/dpm" bootstrap "${extracted}"
46+
47+
Windows
48+
-------
49+
50+
Download and upack the latest dpm sdk version's `archive (.zip) <https://get.digitalasset.com/install/latest-windows-archive.html>`_, then:
51+
52+
.. code:: powershell
53+
54+
# Extract the downloaded zip ($ZIP_PATH) to temp directory
55+
$EXTRACTED = Join-Path "$env:TEMP" "extracted"
56+
New-Item -ItemType Directory -Path $EXTRACTED | Out-Null
57+
Expand-Archive -Path $ZIP_PATH -DestinationPath $EXTRACTED
58+
59+
& "$EXTRACTED\windows-amd64\bin\dpm.exe" bootstrap $EXTRACTED\windows-amd64

0 commit comments

Comments
 (0)