Setup Chromia Account

Install Chromia CLI

You can install Chromia CLI using a package manager or by downloading it directly from Chromia CLI Packages.

macOS

To install Chromia CLI (chr) on macOS, follow these steps:

1. If Homebrew is not installed, install it by running:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Add the Chromia repository to Homebrew by running the following command:

   brew tap chromia/core https://gitlab.com/chromaway/core-tools/homebrew-chromia.git

3. Install Chromia CLI with:

   brew install chromia/core/chr

4. To verify the installation, check the version by running:

   chr --version

Linux/WSL

To install Chromia CLI (chr) on Linux or WSL (Windows Subsystem for Linux), follow these steps:

1. Download and add Chromia's apt-repo public key to your system’s trusted keyrings:

   curl -fsSL https://apt.chromia.com/chromia.gpg | sudo tee /usr/share/keyrings/chromia.gpg

2. Add the Chromia repository to your list of package sources:

   echo "deb [arch=amd64 signed-by=/usr/share/keyrings/chromia.gpg] https://apt.chromia.com stable main" | sudo tee /etc/apt/sources.list.d/chromia.list

3. Run the following command to update your package sources:

   sudo apt-get update

   Info: If you added apt.chromia.com before Chromia CLI version 0.16.0, run the following command to allow the repository update:

   sudo apt-get --allow-releaseinfo-change update

4. Once the repository is updated, install Chromia CLI by running:

   sudo apt-get install chr

5. To verify that Chromia CLI is installed successfully, check the version:

   chr --version

Windows

To install Chromia CLI (chr) on Windows using Scoop, follow these steps:

1. If Scoop is not installed, install it by running the following command in PowerShell (run as Administrator):

   iwr -useb get.scoop.sh | iex

2. Add the Chromia repository (bucket) to Scoop by running:

   scoop bucket add chromia https://gitlab.com/chromaway/core-tools/scoop-chromia/

3. Add the Java bucket to Scoop by running:

   scoop bucket add java

   This will enable Scoop to download the OpenJDK 21, which Chromia CLI depends on when installing.

4. Install Chromia CLI by running:

   scoop install chr

5. To verify that Chromia CLI is installed successfully, check the version:

   chr --version

Create Private Keys

chr keygen -f eval_engine_key

You can find the generated private key in the eval_engine_key file. Save this private key in your environment variables.

The file will contain content similar to this:

#Keypair generated using secp256k1
#Sat Jan 25 08:25:39 MYT 2025
privkey=XXXXX
pubkey=XXXXX

Important: Do not commit the eval_engine_key file to git version control