Open source. Literally.
Every line of code is available to read, copy, modify, and self-host. Under AGPL-3.0. Forever.
github.com/ghhamza/maqraaLicense: AGPL-3.0
What this license means for you
✓ Allowed
- ✓Use the platform for free, for any purpose
- ✓Copy and modify the code
- ✓Self-host the platform on your servers
- ✓Build products on top of the code
- ✓Commercial use (within license terms)
◯ License terms
- ◯Contributions and modifications stay under AGPL-3.0
- ◯If you publish a modified hosted version, you must publish your changes
- ◯Original authors must be credited
- ◯A copy of the license must be included
Why AGPL and not MIT or Apache?
We chose AGPL-3.0 over more permissive licenses (like MIT or Apache) for one simple reason: we want improvements to stay open, even when hosted in the cloud.
Permissive licenses let large companies take the code, build a closed version of it, and offer it as a paid cloud service without sharing improvements with the community. This has happened repeatedly in other open source projects.
AGPL closes that loophole: anyone hosting a modified version of Maqraa as a service must publish their changes. This guarantees the community benefits from every improvement, not just companies.
For the teacher using app.maqraa.org or self-hosting — the license has no practical impact. AGPL only affects those who build a modified version and offer it to others.
Self-host on your own server
A quick self-hosting guide — for institutes, developers, or anyone wanting full privacy
A modest server
Linux server (Ubuntu 22+ preferred), at least 2GB RAM, 20GB disk. PostgreSQL 16+. Node.js and Rust to build.
Clone the repo and install requirements
A single git clone, configure .env with the basics, run the database.
Run the platform
With docker compose up or manually. Nginx + Let's Encrypt for the domain. Full guide on GitHub.
# Self-host in 3 commands git clone https://github.com/ghhamza/maqraa cd maqraa && cp .env.example .env # edit values docker compose up -d
Contribute to the project
There's more than one way to contribute — even if you're not a developer
Code contributions
Open a Pull Request on GitHub. We review every contribution, and welcome code from all skill levels.
Contributing guide →Bug reports
Found a bug? Open an Issue on GitHub with clear details. We triage reports regularly.
Report a bug →Feature requests
Got an idea? Share it with us. The best features come from teachers themselves.
Suggest a feature →Translation
Help translate the platform into your language. We need reviews for Arabic, English, French, and more coming.
Help translate →Roadmap
We run the project roadmap publicly on GitHub Projects. Every planned feature, every change in progress, every priority — visible to everyone.
Join the community
Maqraa is built on by individuals and institutions around the world. Be part of it.