Setup and run

Environment

The default configuration will stand up the following environment:

• NGROK Traction Agent. An ngrok public endpoint for ACA-Py agent... see ACAPY_HTTP_PORT environment variable (8030).
• Traction Agent. Multitenanted Aca-Py with Traction Plugins
• Tenant Proxy. NGINX proxy for tenant API... see TENANT_PROXY_PORT environment variable (8032).
• Traction DB. Postgresql database for Traction Agent Aca-Py
• Tenant UI. Vue 3 application for innkeeper (tenant onboarding) and tenants... see TENANT_UI_PORT environment variable (5101).
• Endorser API. Controller for endorser running locally.
• Endorser Agent. Aca-Py configured for endorser role.
• Endorser DB. Postgresql database for Endorser Agent Aca-Py

Endpoints

• Tenant Proxy Swagger
• Tenant UI - Innkeeper
• Tenant UI - Tenants

Credentials

• innkeeper / change-me

External dependencies

• BCovrin Test ledger... see ACAPY_GENESIS_URL environment variable (http://test.bcovrin.vonx.io/genesis).
• previously registered Endorser DID... see ACAPY_ENDORSER_PUBLIC_DID environment variable.

start

1. copy .env-example to .env and adjust as necessary for your environment
2. bring up traction

cp .env-example .env
docker compose build
docker compose up

build images directly

Assume starting in /scripts...

cd ../plugins/docker
docker build -f ./Dockerfile --tag traction:plugins-acapy ..
cd ../../services/aca-py
docker build -f ./Dockerfile.acapy --tag traction:traction-agent .
cd ../../scripts
docker compose up

stop

This will leave the volume (data) intact and available on restart.

docker compose down

teardown

This will remove the volume, so next start/up will re-recreate a new environment.

docker compose down -v --remove-orphans