Build and Run Services
Build all services with Maven and start them in the correct dependency order.
Services must be built and started in dependency order. The platform infrastructure (Service Registry, Config Server, API Gateway) runs in Docker. The three business services run locally on the host.
1. Build the Common Library
Powershell code-highlight
cd arya-banking-common
mvn clean install -DskipTests
This publishes the shared library to your local Maven repository (
~/.m2/repository). All other services depend on it. You only need to rebuild it when the common library changes.2. Build All Business Services
Powershell code-highlight
cd ../arya-banking-user-service
mvn clean package -DskipTests
cd ../arya-banking-auth-service
mvn clean package -DskipTests
cd ../arya-banking-admin-service
mvn clean package -DskipTests
These can be built in any order — they only need the arya-banking-common artifact in your local .m2 cache.
3. Start Services
User Service (port 8086)
Powershell code-highlight
cd arya-banking-user-service
mvn spring-boot:run
Auth Service (port 8087)
Powershell code-highlight
cd arya-banking-auth-service
mvn spring-boot:run
Admin Service (port 8089)
Powershell code-highlight
cd arya-banking-admin-service
mvn spring-boot:run
Use separate terminal windows for each service, or run them in the background with
mvn spring-boot:run > service.log 2>&1.4. Expected Startup Behavior
After starting each service, it will:
- Register with Eureka (visible at http://localhost:8761)
- Fetch configuration from the Config Server
- Authenticate to Vault using the AppRole credentials in
vault-credentials.yml - Load secrets into the Spring environment
If a service fails to start, check the Troubleshooting page for common issues.