Install Dynatrace Configuration as Code

This guide shows you how to download the Dynatrace Configuration as Code CLI and install it on your operating system.

Install the Dynatrace Configuration as Code CLI

LinuxmacOSWindows

Download the latest version of the Dynatrace Configuration as Code CLI tool.

Linux 64 bitLinux 32 bit

shell
curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-linux-amd64 -o monaco

shell
curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-linux-386 -o monaco

optional Verify the downloaded binary using the checksum.
Verify the downloaded binary using the checksum
To verify that the downloaded binary is valid, download its checksum file:
Linux 64 bitLinux 32 bit
shell
curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-linux-amd64.sha256 -o monaco.sha256
shell
curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-linux-386.sha256 -o monaco.sha256
Verify the downloaded binary using the checksum:
```
shell
shasum -c monaco.sha256
```
You should see the following output:
monaco: OK
This requires monaco and monaco.sha256 to be in the same directory, which they are if you followed the steps above.
Make the binary executable:
```
shell
chmod +x monaco
```
optional Install Dynatrace Configuration as Code CLI to a central location in your PATH.
```
shell
sudo mv monaco /usr/local/bin/
```
This command assumes that you downloaded the binary to the current folder with the cUrl command described in step 1 and that your $PATH includes /usr/local/bin.

Download the latest version of the Dynatrace Configuration as Code CLI tool.

Apple Silicon (M1/M2)Intel 64 bit

shell
curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-darwin-arm64 -o monaco

shell
curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-darwin-amd64 -o monaco

optional Verify the downloaded binary using the checksum.
Verify the downloaded binary using the checksum
To verify that the downloaded binary is valid, download its checksum file:
Apple Silicon (M1/M2)Intel 64bit
shell
curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-darwin-arm64.sha256 -o monaco.sha256
shell
curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-darwin-amd64.sha256 -o monaco.sha256
Verify the downloaded binary using the checksum:
```
shell
shasum -c monaco.sha256
```
You should see the following output:
monaco: OK
This requires monaco and monaco.sha256 to be in the same directory, which they are if you followed the steps above.
Make the binary executable:
```
shell
chmod +x monaco
```
optional Install Dynatrace Configuration as Code CLI to a central location in your PATH.
```
shell
sudo mv monaco /usr/local/bin/
```
This command assumes that you downloaded the binary to the current folder with the cUrl command described in step 1 and that your $PATH includes /usr/local/bin.

Download the latest version of the Dynatrace Configuration as Code CLI tool.

Windows 64 bitWindows 32 bit

shell
Invoke-WebRequest -URI https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-windows-amd64.exe -OutFile monaco.exe

shell
Invoke-WebRequest -URI https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-windows-386.exe -OutFile monaco.exe

This executable is signed by Dynatrace.

optional Add Monaco to a central location in your PATH.
How to configure your PATH
1. Move monaco to the folder you want to add your PATH.
2. Go to Environment Variables in your system settings.
3. Scroll through system variables until you find PATH.
4. Edit and change accordingly.
  - Include a semicolon at the end of the previous as that is the delimiter, i.e., c:\path;<your-new-path>.
5. Launch a new console for the settings to take effect.

Run monaco

Execute the monaco command to try out the downloaded CLI

shell
> monaco
2023/01/30 15:17:57 INFO  Dynatrace Configuration as Code v2.x
Tool used to deploy dynatrace configurations via the cli

Examples:
  Deploy configuration defined in a manifest
    monaco deploy service.yaml
  Deploy a specific environment within an manifest
    monaco deploy service.yaml -e dev

Usage:
  monaco <command> [flags]
  monaco [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  convert     Convert v1 monaco configuration into v2 format
  delete      Delete configurations defined in delete.yaml from the environments defined in the manifest
  deploy      Deploy configurations to Dynatrace environments
  download    Download configuration from Dynatrace
  help        Help about any command

Flags:
  -h, --help      help for monaco
  -v, --verbose   Enable debug logging

Use "monaco [command] --help" for more information about a command

What's next

Learn by doing. Deploy your first configuration.