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 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. Point it at the correct binaries path 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 the new environment variables take effect. Then run these two commands, one after the other, to set up 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. Install Homebrew if you don't have it yet:

   /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 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, 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 requires during installation.

4. Install Chromia CLI:

   scoop install chr

5. Confirm the installation by printing the version:

   chr --version