Version: Next

Install Monaco

This guide shows you how to download Monaco and install it on your operating system (Linux/macOS or Windows).

Go to the Monaco release page.
Download the appropriate version.
Check that the Monaco binary is available on your PATH. This process will differ depending on your operating system (see steps below).

Operating System

Linux / macOS
Windows

For Linux/macOS, we recommend using curl. You can download it from here or use wget.

# Linux
# x64
 curl -L https://github.com/dynatrace/dynatrace-configuration-as-code/releases/download/v1.8.9/monaco-linux-amd64 -o monaco

# x86
 curl -L https://github.com/dynatrace/dynatrace-configuration-as-code/releases/download/v1.8.9/monaco-linux-386 -o monaco

# macOS
 curl -L https://github.com/dynatrace/dynatrace-configuration-as-code/releases/download/v1.8.9/monaco-darwin-amd64 -o monaco
 
 # macOS - Apple Silicon (M1/M2)
 curl -L https://github.com/dynatrace/dynatrace-configuration-as-code/releases/download/v1.8.9/monaco-darwin-arm64 -o monaco

Make the binary executable:

 chmod +x monaco

Optionally, install Monaco to a central location in your PATH. This command assumes that the binary is currently in your downloads folder and that your $PATH includes /usr/local/bin:

# Use any path that suits you; this is just a standard example. Install sudo if needed.
sudo mv ~/Downloads/monaco /usr/local/bin/

Now you can execute the monaco command to verify the download.

monaco
You are currently using the old CLI structure which will be used by
default until monaco version 2.0.0
Check out the beta of the new CLI by adding the environment variable
  "NEW_CLI".
We can't wait for your feedback.
NAME:
   monaco-linux-amd64 - Automates the deployment of Dynatrace Observability and Security Configuration to one or multiple Dynatrace environments.
USAGE:
   monaco-linux-amd64 [global options] command [command options] [working directory]
VERSION:
   1.8.9
DESCRIPTION:
   Tool used to deploy dynatrace configurations via the cli
   Examples:
     Deploy a specific project inside a root config folder:
       monaco -p='project-folder' -e='environments.yaml' projects-root-folder
     Deploy a specific project to a specific tenant:
       monaco --environments environments.yaml --specific-environment dev --project myProject
COMMANDS:
   help, h  Shows a list of commands or help for one command
GLOBAL OPTIONS:
   --verbose, -v                             (default: false)
   --environments value, -e value            Yaml file containing environments to deploy to
   --specific-environment value, --se value  Specific environment (from list) to deploy to (default: none)
   --project value, -p value                 Project configuration to deploy (also deploys any dependent configurations) (default: none)
   --dry-run, -d                             Switches to just validation instead of actual deployment (default: false)
   --continue-on-error, -c                   Proceed deployment even if config upload fails (default: false)
   --help, -h                                show help (default: false)
   --version                                 print the version (default: false)

Before you start, you need to set the PATH on Windows:

Go to Control Panel -> System -> System settings -> Environment Variables.
Scroll down in system variables until you find PATH.
Click edit and change accordingly.
Include a semicolon at the end of the previous as that is the delimiter, i.e., c:\path;c:\path2
Launch a new console for the settings to take effect.

Once your PATH is set, verify the installation by running monaco from your terminal.

 monaco
You are currently using the old CLI structure which will be used by
default until monaco version 2.0.0

Check out the beta of the new CLI by adding the environment variable
  "NEW_CLI".

We can't wait for your feedback.

NAME:
   monaco.exe - Automates the deployment of Dynatrace Observability and Security Configuration to one or multiple Dynatrace environments.

USAGE:
   monaco.exe [global options] command [command options] [working directory]

VERSION:
   1.8.9

DESCRIPTION:
   Tool used to deploy dynatrace configurations via the cli

   Examples:
     Deploy a specific project inside a root config folder:
       monaco -p='project-folder' -e='environments.yaml' projects-root-folder

     Deploy a specific project to a specific tenant:
       monaco --environments environments.yaml --specific-environment dev --project myProject

COMMANDS:
   help, h  Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --verbose, -v                             (default: false)
   --environments value, -e value            Yaml file containing environments to deploy to
   --specific-environment value, --se value  Specific environment (from list) to deploy to (default: none)
   --project value, -p value                 Project configuration to deploy (also deploys any dependent configurations) (default: none)
   --dry-run, -d                             Switches to just validation instead of actual deployment (default: false)
   --continue-on-error, -c                   Proceed deployment even if config upload fails (default: false)
   --help, -h                                show help (default: false)
   --version                                 print the version (default: false)

Now that Monaco is installed, follow our introductory guide on how to deploy a configuration to Dynatrace.