Set up your project

1. Set up Homebrew by following the Homebrew installation guide.

2. Install PostgreSQL with Homebrew:

   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. Set up 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 download page.

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

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

3. Close and reopen the Command Prompt (CMD) so it picks up the new environment variables. 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. Register the Chromia repository with 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. Fetch the public key for Chromia's apt-repo and add it 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 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. Refresh your package sources:

   sudo apt-get update

4. After the sources are refreshed, 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, open PowerShell as Administrator and run:

   iwr -useb get.scoop.sh | iex

2. Add the Chromia 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