Files
proxmox/omnl-fineract/SETUP.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00

43 lines
1.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 directorys `.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.