abdofallah/iqraai-proxy repository overview

⁠

⁠Iqra AI - Proxy Gateway

Iqra AI is an orchestration infrastructure designed to bridge the gap between the chaos of LLMs and the reliability of business code.

This image contains the Proxy node for Iqra AI. It acts as the primary signaling gateway for telephony providers (such as Twilio, Telnyx, etc.). It processes incoming provider statuses, handles initial SIP requests (which it forwards to the Backend to activate the live session), and actively manages the outbound call queue for its specific region.

⁠Quick Start (Docker Compose)

Because this node handles active SIP signaling and UDP traffic, it must be run with network_mode: "host" to avoid Docker NAT overhead and ensure sub-second reliability.

version: '3.8'

services:
  proxy:
    image: abdofallah/iqraai-proxy:latest
    container_name: iqra-proxy
    restart: always
    network_mode: "host" 
    volumes:
      # Hardware monitoring mounts (Read-Only access to host metrics)
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
      
      # Configuration mount (Read-Only)
      - ./appsettings.json.proxy:/app/appsettings.json:ro

⁠Configuration

Before running the container, you must provide the configuration file. Download the example template here: 👉 appsettings.json.example⁠

Make sure Hardware:IsDockerContainer is set to true in the configuration if hardware monitoring mounts are being used (as else it will use the containers /proc & /sys where as setting it to true looks for /host/proc & /host/sys in the container).

⁠Links & Resources

• GitHub Repository: abdofallah/IqraAI⁠
• Website: iqra.bot⁠
• Self-Hosting Docs: docs.iqra.bot/developers/self-hosting⁠