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.9.2_darwin_arm64.tar.gz
	Intel	greymatter-cli_4.9.2_darwin_amd64.tar.gz
	Arm	greymatter-cli_4.9.2_linux_arm64.tar.gz
	Intel	greymatter-cli_4.9.2_linux_amd64.tar.gz
	Arm	greymatter-cli_4.9.2_windows_arm64.tar.gz
	Intel	greymatter-cli_4.9.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 to contain your information.

Mac / Linux

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.

Windows

To run the executable please navigate to the directory you unpacked greymatter.exe and Run the following command using the terminal:

./greymatter.exe

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

Setup a Greymatter Admin Repository

The Greymatter Application Networking 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. Initialize your new repository by running the following commands. This sets up the Greymatter application networking platform core configurations for GitOps.

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

mkdir greymatter-core
tar -xvf greymatter-core.tar.gz -C greymatter-core
cd greymatter-core
git init
git remote add origin git@github.com:<your-org>/greymatter-core.git
git checkout -b main
git add -A
git commit -m "start of your greymatter journey"
git push --set-upstream origin main

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

Be sure to change jfrog_username, jfrog_identity_token_id, and your git@github.com:<your-org>/greymatter-core.git to contain your information.

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.