Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
June 16, 2023 11:29
June 16, 2023 11:29
July 13, 2022 19:12
June 7, 2023 19:01
September 13, 2022 15:18
July 25, 2022 12:00
July 20, 2023 12:31
November 9, 2018 10:44
June 7, 2023 19:01
July 11, 2017 15:03
March 23, 2023 14:14
January 8, 2019 11:46

بِسْمِ اللهِ الرَّحْمٰنِ الرَّحِيْمِ

CircleCI GitHub All Releases

Al Quran Cloud

This is the code you see deployed on This documentation explains how you can get setup to deploy your own instance and contribute code.

Technology Stack and Requirements

  • PHP 8.1
  • Composer - See composer.json for other dependencies
  • Slim Framework 4
  • Bootstrap 3
  • JQuery
  • Bootstrap Multiselect
  • Docker

Getting Started

Running the App

The app is fully Dockerised. You just need docker to spin it up.

A production ready Docker image of the app is published as:

  • on Quay
  • on Docker Hub

To get your own instance up, simply run:

docker run -it -p 8081:8080

You can now visit http://localhost:8081/ and start using it.

Build and Contribute

Please note that the Dockerfile included builds a production ready container which has opcache switched on and xdebug turned off, so you will only see your changes every 5 minutes if you are developing. To actively develop, change the FROM vesica/php72:latest line to vesica/php72:dev.

  1. Clone this repository
  2. Run docker build . -t This will build an image with production dependencies only.
  3. Run docker run -it -p 8081:8080 -v $(pwd)/.:/var/www to spin up the built image.
  4. Run composer install to add development dependencies.
  5. Make sure you have internet connectivity so the app can connect to
  6. Open your browser and browse to http://localhost:8081/.
  7. Any changes you make will be synced to the Docker container. You just refresh the page in the browser to see them.

Scaling and Sizing

This app takes 15 MB per apache process / worker and is set to have a maximum of 20 Apache workers.

A single instance should be sized with a maximum of 512 MB RAM, after which you should scale it horizontally.

Contributing Code

You can contribute code by raising a pull request.

There's a backlog of stuff under issues for things that potentially need to be worked on, so please feel free to pick something up from there or contribute your own improvements.

You can also join the community at or the Islamic Network Discord Server to discuss any of the apps or APIs @