# OMNL Fineract — Setup Guide

## 1. Create local environment

```bash
cd omnl-fineract
cp .env.example .env
```

Edit `.env` and set:

- `OMNL_FINERACT_PASSWORD` — the real password (never commit this file).

## 2. Verify connectivity

From this directory (with `.env` in place):

```bash
source .env 2>/dev/null || true
export $(grep -v '^#' .env | xargs) 2>/dev/null || true

curl -s -u "${OMNL_FINERACT_USER}:${OMNL_FINERACT_PASSWORD}" \
  -H "Fineract-Platform-TenantId: ${OMNL_FINERACT_TENANT}" \
  "${OMNL_FINERACT_BASE_URL}/offices"
```

You should get a JSON array of offices (e.g. Head Office, SHAMRAYAN ENTERPRISES).

## 3. Using from parent repo

If this directory is at the workspace root (e.g. `proxmox/omnl-fineract/`), scripts can load the parent `.env` that includes the same variables (see root `.env.example`). Alternatively, source this directory’s `.env` before running scripts:

```bash
source /path/to/proxmox/omnl-fineract/.env
# then run your script
```

## Security

- **Do not** commit `.env` or any file containing the real password.
- `.env` is listed in `.gitignore`.
- Prefer storing the password in a secrets manager or CI secret and injecting it at runtime.