d2/docs/INSTALL.md

1.6 KiB

install

This file documents all the ways by which you can install d2.

install.sh

# With --dry-run the install script will print the commands it will use
# to install without actually installing so you know what it's going to do.
curl -fsSL https://d2lang.com/install.sh | sh -s -- --dry-run
# If things look good, install for real.
curl -fsSL https://d2lang.com/install.sh | sh -s --

For help on the terminal run including the supported package managers and detection methods see:

curl -fsSL https://d2lang.com/install.sh | sh -s -- --help

Standalone

We publish standalone release archives with every release on github. Download the .tar.gz release for your OS/ARCH combination and then run:

make install

Inside the extracted directory to install.

make uninstall

To uninstall. You will be prompted for sudo/su/doas if root permissions are required for installation. You can control the unix hierarchy installation path with PREFIX=. For example:

# Install under ~/.local.
# Binaries will be at ~/.local/bin
# And manpages will be under ~/.local/share/man
# And supporting data like icons and fonts at ~/.local/share/d2
make install PREFIX=$HOME/.local

The install script places the standalone release into $PREFIX/lib/d2/d2-<version> and we recommend doing the same with manually installed releases so that you know where the release directory is for easy uninstall.

macOS (Homebrew)

For macOS you may install as so:

brew tap terrastruct/d2
brew install d2