Install Dynatrace Configuration as Code via Monaco

This guide shows you how to download and install Dynatrace Configuration as Code via Monaco (the Dynatrace Monaco CLI).

Install the Dynatrace Monaco CLI

Linux

Linux 64 bitLinux 32 bit

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

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

optional Verify the downloaded binary using the checksum.
How to verify the downloaded binary using the checksum
To verify that the downloaded binary is valid
1. Download its checksum file.
```
shell
curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-linux-amd64.sha256 -o monaco.sha256
```
1. Verify the downloaded binary using the checksum.
```
shell
shasum -c monaco.sha256
```
  You should see the following output.
```
shell
monaco-linux-amd64: OK
```
  This requires monaco-linux-amd64 and monaco.sha256 to be in the same directory, which they are if you followed the steps above.

Rename the specific executable to monaco.

shell
mv monaco-linux-amd64 monaco

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.

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

optional Verify the downloaded binary using the checksum.
How to verify the downloaded binary using the checksum
To verify that the downloaded binary is valid
1. Download its checksum file.
```
shell
curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-linux-386.sha256 -o monaco.sha256
```
1. Verify the downloaded binary using the checksum.
```
shell
shasum -c monaco.sha256
```
  You should see the following output.
```
shell
monaco-linux-386: OK
```
  This requires monaco-linux-386 and monaco.sha256 to be in the same directory, which they are if you followed the steps above.

Rename the specific executable to monaco.

shell
mv monaco-linux-386 monaco

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.

macOS

Apple Silicon (M1/M2)Intel 64 bit

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

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

optional Verify the downloaded binary using the checksum.
How to verify the downloaded binary using the checksum
To verify that the downloaded binary is valid
1. Download its checksum file.
```
shell
curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-darwin-arm64.sha256 -o monaco.sha256
```
1. Verify the downloaded binary using the checksum.
```
shell
shasum -c monaco.sha256
```
  You should see the following output.
```
shell
monaco-darwin-arm64: OK
```
  This requires monaco-darwin-arm64 and monaco.sha256 to be in the same directory, which they are if you followed the steps above.

Rename the specific executable to monaco.

shell
mv monaco-darwin-arm64 monaco

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.

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

optional Verify the downloaded binary using the checksum.
How to verify the downloaded binary using the checksum
To verify that the downloaded binary is valid
1. Download its checksum file.
```
shell
curl -L https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-darwin-amd64.sha256 -o monaco.sha256
```
1. Verify the downloaded binary using the checksum.
```
shell
shasum -c monaco.sha256
```
  You should see the following output.
```
shell
monaco-darwin-amd64: OK
```
  This requires monaco-darwin-amd64 and monaco.sha256 to be in the same directory, which they are if you followed the steps above.

Rename the specific executable to monaco.

shell
mv monaco-darwin-amd64 monaco

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.

Windows

Windows 64 bitWindows 32 bit

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

shell
Invoke-WebRequest -URI https://github.com/Dynatrace/dynatrace-configuration-as-code/releases/latest/download/monaco-windows-amd64.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.
  - Use a semicolon delimiter between the previous entry and your new path (c:\path;<your-new-path>).
5. Launch a new console for the settings to take effect.

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

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.
  - Use a semicolon delimiter between the previous entry and your new path (c:\path;<your-new-path>).
5. Launch a new console for the settings to take effect.

Container image

A container image of the Dynatrace Monaco CLI is available to simplify usage in CI/CD pipelines.

Images are available via Docker Hub:

shell
docker pull dynatrace/dynatrace-configuration-as-code:latest

You can use the image directly with the CLI commands or as a CI container with a monaco executable available inside.

The container image uses the monaco executable as its entrypoint, so any inputs are passed directly to it.

However, some CI/CD tools (for example, GitLab CI/CD) need a regular shell as entrypoint. To make the container image work with these tools, you need to overwrite the entrypoint with sh.

GitLab CI/CD

For details on how to use the image with GitLab CI/CD, follow the Override the entrypoint of an image GitLab documentation.
docker run

For general information on overwriting container entrypoints when using docker run, see the Docker documentation.

Verify the image signature

Dynatrace Monaco CLI version 2.2.0+

The container image is signed to allow you to verify its authenticity.

Verify the container image signature

You can verify the signature using cosign and the cosign.pub key that can be downloaded from the GitHub release page.

To verify the signature of a given version

Install the applicable version of cosign for your operating system, following the installation instructions.
Download the cosign.pub public key from the GitHub release page of the version you wish to verify.

Verify the container image of the version you wish to check:

shell
cosign verify --key cosign.pub dynatrace/dynatrace-configuration-as-code:[VERSION]

For example, to verify version 2.2.0:

shell
cosign verify --key cosign.pub dynatrace/dynatrace-configuration-as-code:2.2.0

Run monaco

Execute the monaco command to try out the downloaded CLI.

shell
> monaco
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
  generate    Generate offers several sub-commands to generate files - take a look at the sub-commands for usage
  help        Help about any command
  version     Prints out the version of the monaco cli

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

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

What's next

Learn by doing in Deploy your first configuration.
Learn how available memory and CPU impact deployments in Hardware requirements for Dynatrace Monaco CLI.