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.