Core Setup

Get the CLI

We build the Greymatter CLI to support multiple operating systems and architectures. Choose the file you need to download for your OS and Architecture from the below table.

OS	Arch	Filename
	M Arch (Arm)	greymatter-cli_4.11.2_darwin_arm64.tar.gz
	Intel	greymatter-cli_4.11.2_darwin_amd64.tar.gz
	Arm	greymatter-cli_4.11.2_linux_arm64.tar.gz
	Intel	greymatter-cli_4.11.2_linux_amd64.tar.gz
	Arm	greymatter-cli_4.11.2_windows_arm64.tar.gz
	Intel	greymatter-cli_4.11.2_windows_amd64.tar.gz

Use the following curl command to download the Greymatter CLI for your operating system:

curl -u <jfrog-username>:<jfrog_identity-token-id> -O \
    https://greymatter.jfrog.io/artifactory/generic/greymatter-cli/<cli-version-os-arch> && 
    tar -xvf <cli-version-os-arch>

Be sure to change jfrog-username, jfrog-identity-token-id, and cli-version-os-arch in the above command.

Mac / Linux (and WSL)

Move the binary to your $PATH (example: /usr/local/bin). After moving the binary to your path, verify your installation by running:

greymatter

This will display information about the CLI and helpful inline assistance.

If you receive an error after running the greymatter command:

• verify your PATH includes the location where you moved the binary

• check the binary's file permissions (it should be executable)

• ensure you downloaded the correct binary for your system.

If you are on a Mac, you may need to make the binary executable using the following cmd in terminal: chmod +x greymatter

Setup a Greymatter Admin Repository

The Greymatter Service Connectivity Platform has an out-of-the-box working core bundle that is managed using GitOps and installed into Kubernetes using an Operator. These next steps will ensure your environment is setup and ready for a quick kubernetes installtion.

1. Create a private repository named greymatter-core in your Git repository.

2. Using your shell, download the core Greymatter Service Connectivity Platform bundle, unpack it and cd into the root of the directory.

3. Check the bundle into the private repository you created in step one, we will use this during setup.

curl -u <jfrog_username>:<jfrog_identity_token_id> -o greymatter-core.tar.gz "https://greymatter.jfrog.io/artifactory/generic/greymatter-core/greymatter-core_0.21.2_none_none.tar.gz"

mkdir greymatter-core
tar -xvf greymatter-core.tar.gz -C greymatter-core
cd greymatter-core

Be sure to change jfrog_username, jfrog_identity_token_id in the above command.

Navigate to the Git repository you just created and it will be populated with the initial Greymatter Core configurations! You are now ready for an initial installation.