Set up your project

1. Install Homebrew by following the Homebrew installation guide.

2. Install PostgreSQL:

   brew install postgresql@16brew services start postgresql@16createuser -s postgres

3. Create and configure the database:

   psql -U postgres -c "CREATE DATABASE postchain WITH TEMPLATE = template0 LC_COLLATE = 'C.UTF-8' LC_CTYPE = 'C.UTF-8' ENCODING 'UTF-8';" -c "CREATE ROLE postchain LOGIN ENCRYPTED PASSWORD 'postchain'; GRANT ALL ON DATABASE postchain TO postchain;"

1. Install PostgreSQL:

   sudo apt install postgresql-16

2. Create and configure the database:

   sudo -u postgres psql -c "CREATE DATABASE postchain WITH TEMPLATE = template0 LC_COLLATE = 'C.UTF-8' LC_CTYPE = 'C.UTF-8' ENCODING 'UTF-8';" -c "CREATE ROLE postchain LOGIN ENCRYPTED PASSWORD 'postchain'; GRANT ALL ON DATABASE postchain TO postchain;"

1. Install Docker by following the Docker installation guide.

2. Create and configure the database:

   docker run --name postgres -e POSTGRES_USER=postchain -e POSTGRES_PASSWORD=postchain -p 5432:5432 -d postgres:16.3-alpine3.20

1. Get the PostgreSQL installer from the PostgreSQL website.

2. Run the installer, then add the PostgreSQL folder that holds the binaries to your environment variables. In Command Prompt (CMD), run the command below. Point it at your actual binaries path and substitute the real version number for the <version> placeholder:

   setx POSTGRESQL "C:\Program Files\PostgreSQL\<version>\bin"

3. Close and reopen Command Prompt (CMD) so the new environment variables take effect. Then run these two commands, one after the other, to create and configure the database:

   psql -U postgres -c "CREATE DATABASE postchain WITH TEMPLATE = template0 LC_COLLATE = 'en_US.UTF-8' LC_CTYPE = 'en_US.UTF-8' ENCODING 'UTF-8';"psql -U postgres -c "CREATE ROLE postchain LOGIN ENCRYPTED PASSWORD 'postchain'; GRANT ALL ON DATABASE postchain TO postchain;"

On macOS, install Chromia CLI (chr) as follows:

1. If you don't have Homebrew yet, install it:

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

2. Add the Chromia repository to Homebrew:

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

3. Install Chromia CLI:

   brew install chromia/core/chr

4. Confirm the installation by printing the version:

   chr --version

On Linux or WSL (Windows Subsystem for Linux), install Chromia CLI (chr) as follows:

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

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

2. Register the Chromia repository as a package source:

   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. Refresh your package sources:

   sudo apt-get update

4. After the update finishes, install Chromia CLI:

   sudo apt-get install chr

5. Confirm the installation by printing the version:

   chr --version

On Windows, install Chromia CLI (chr) with Scoop as follows:

1. If you don't have Scoop yet, install it by running this in PowerShell as Administrator:

   iwr -useb get.scoop.sh | iex

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

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

3. Add the Java bucket to Scoop:

   scoop bucket add java

   With this bucket in place, Scoop can fetch openjdk21, which chromia-cli needs during installation.

4. Install Chromia CLI:

   scoop install chr

5. Confirm the installation by printing the version:

   chr --version