Local Development Setup

Step-by-step guide to setting up and running the full Arya Banking platform on your local machine.

Introduction to the local development environment for the Arya Banking platform.

Clone Repositories

Clone all 9 repositories required for the Arya Banking platform.

GitHub Packages Auth

Configure Maven and Docker to authenticate with GitHub Packages.

Start Infrastructure

Launch all Docker-based infrastructure services for the platform.

Bootstrap Vault

Initialize and unseal HashiCorp Vault for local development.

Configure Keycloak

Set up the Keycloak realm, OAuth2 client, and test users for local development.

Create Vault Credentials

Configure per-service vault-credentials.yml files for Vault AppRole authentication.

Build and Run Services

Build all services with Maven and start them in the correct dependency order.

Verify the Platform

Health checks and smoke tests to confirm the platform is running correctly.

Troubleshooting

Common issues encountered during local development and how to resolve them.