Install Datum via Homebrew with the following command:

# Tap the Datum Cloud formula repository (only needs to be done once)
brew tap datum-cloud/homebrew-tap

# Install datumctl
brew install datumctl

# Upgrade datumctl
brew upgrade datumctl

The easiest way to install datumctl is by downloading the pre-built binary for your operating system and architecture from the GitHub Releases page.

Manual Download:

1. Go to the Latest Release.
2. Find the appropriate archive (.tar.gz or .zip) for your system (e.g., datumctl_Linux_x86_64.tar.gz, datumctl_Windows_amd64.zip, datumctl_Darwin_arm64.tar.gz).
3. Download and extract the archive.
4. Move the datumctl (or datumctl.exe) binary to a directory in your system’s PATH (e.g., /usr/local/bin on Linux/macOS, or a custom directory you’ve added to the PATH on Windows).
5. Ensure the binary is executable (chmod +x /path/to/datumctl on Linux/macOS).

Using curl (Example for Linux/macOS):

This example shows how to download and install a specific version. You must:

1. Replace <version> with the desired release tag (e.g., v0.1.0).
2. Replace <archive_filename> with the exact filename for your OS and architecture found on the releases page (e.g., datumctl_Darwin_arm64.tar.gz).

VERSION="<version>"
ARCHIVE="<archive_filename>"
curl -sSL "https://github.com/datum-cloud/datumctl/releases/download/${VERSION}/${ARCHIVE}" | tar xz
sudo mv datumctl /usr/local/bin/

nix (Linux and macOS)

datumctl ships with a flake.nix so you don’t have to install anything:

# Pick latest from git
nix run github:datum-cloud/datumctl

# Specify version
nix run github:datum-cloud/datumctl/b044455d877b800812e4fd78e42429c1617c011b

# Run from local git clone
nix run

# Start shell with all dependencies available
nix develop --command zsh

# Build locally
nix build

# ...or for specific platform
nix build .#packages.x86_64-linux.default
nix build .#packages.aarch64-linux.default

You can, however, incorporate it into your home-manager build or other flake so that it’s always available in your profile.

datumctl ships with a flake.nix so you don’t have to install anything:

# Pick latest from git
nix run github:datum-cloud/datumctl

# Specify version
nix run github:datum-cloud/datumctl/b044455d877b800812e4fd78e42429c1617c011b

# Run from local git clone
nix run

# Start shell with all dependencies available
nix develop --command zsh

# Build locally
nix build

# ...or for specific platform
nix build .#packages.x86_64-linux.default
nix build .#packages.aarch64-linux.default

You can, however, incorporate it into your home-manager build or other flake so that it’s always available in your profile.

Install datumctl

1. Download the latest Windows release from the GitHub Releases page.

2. Extract the archive.

3. Move the binary to a directory on your system, for example:

C:\Tools\datumctl\

Add to PATH

Add the directory containing datumctl.exe to your PATH so it can be run from any terminal.

Using the UI

1. Open Start and search for: Environment Variables
2. Select: Edit the system environment variables
3. Click: Environment Variables
4. Under System variables, select: Path, then click Edit
5. Click New and add: C:\Tools\datumctl\
6. Click OK to save all changes

Using PowerShell (optional)

[Environment]::SetEnvironmentVariable(
  "Path",
  $env:Path + ";C:\Tools\datumctl\",
  [EnvironmentVariableTarget]::Machine
)

Verify installation

Open a new terminal and run:

datumctl version

If you prefer, you can build datumctl from source:

1. Prerequisites:

• Go (Version 1.21 or later)
• Git

2. Clone the repository:

git clone https://github.com/datum-cloud/datumctl.git
cd datumctl

1. Build the binary:

go build -o datumctl .

2. Install: Move the resulting datumctl binary to a directory in your PATH as described in the pre-built binaries section
3. Verification

To verify the installation, run:

datumctl version

This should output the installed version of datumctl.