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+
PostgreSQL	16	16
Redis	7	7
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

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

redis:
  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

# Database
DATABASE_URL=postgresql://user:pass@host:5432/iof

# Redis
REDIS_URL=redis://host:6379

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

# Optional services
TIGERBEETLE_ADDRESS=host:3000
CLICKHOUSE_URL=http://host:8123
MEILISEARCH_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