Self-Hosted (BYOC)

Self-Hosted (BYOC)

Deploy Islamic Open Finance™ in your own infrastructure.

Overview

Bring Your Own Cloud (BYOC) deployment gives you:

• Full data sovereignty
• Custom security controls
• Integration with existing systems
• Regulatory compliance flexibility

Requirements

Infrastructure

Component	Minimum	Recommended
Kubernetes	1.28+	1.29+
Database	v16	v16
Cache	v7	v7
CPU	8 cores	16 cores
Memory	16 GB	32 GB

Optional Components

Component	Purpose
Ledger Engine	High-performance ledger
Analytics Engine	Real-time analytics
Search Engine	Full-text search

Installation

Using Helm

# Add the IOF Helm repository
helm repo add iof https://charts.islamicopenfinance.com
helm repo update

# Install with default values
helm install iof iof/iof-platform \
  --namespace iof-system \
  --create-namespace

# Or with custom values
helm install iof iof/iof-platform \
  --namespace iof-system \
  --create-namespace \
  -f values.yaml

Example values.yaml

global:
  imageRegistry: ghcr.io/islamic-open-finance

database:
  enabled: true
  auth:
    database: iof
    username: iof

cache:
  enabled: true
  architecture: standalone

railApi:
  replicas: 3
  resources:
    requests:
      memory: 512Mi
      cpu: 250m

ingress:
  enabled: true
  className: nginx
  hosts:
    - host: api.yourbank.com
      paths:
        - path: /
          pathType: Prefix

Configuration

Environment Variables

# Primary Database
DATABASE_URL=your-database-connection-string

# Cache Layer
CACHE_URL=your-cache-connection-string

# Security
JWT_SECRET=your-256-bit-secret
ENCRYPTION_KEY=your-32-byte-key

# Optional services (configure based on your deployment)
LEDGER_ENGINE_ADDRESS=host:3000
ANALYTICS_ENGINE_URL=http://host:8123
SEARCH_ENGINE_URL=http://host:7700

Updates

# Update Helm repository
helm repo update

# Upgrade installation
helm upgrade iof iof/iof-platform \
  --namespace iof-system \
  -f values.yaml

Next Steps

• Codespaces - Development setup
• Architecture - System overview