Your masjid's software. Free, forever.
Prayer displays, donations, a giving kiosk and a madrasa fee desk — running on one computer at the masjid.
Every masjid ends up paying somebody a monthly fee for a prayer screen, a donation page and a card reader — and the donor records live in that somebody's cloud. We think that's backwards. So we build the same software and give it away: no tiers, no licence per screen, no card on file, nothing held back in a paid version. It runs on hardware the masjid already owns, and the data never leaves the building, because there is no server of ours for it to leave to.
Install the platform with one command:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/OpenMasjid-Solutions/OpenMasjidOS/master/install.sh || wget -qO- https://raw.githubusercontent.com/OpenMasjid-Solutions/OpenMasjidOS/master/install.sh)"Then open http://<your-server-ip> on the same network and create your admin account. Everything
else installs from the App Store inside the dashboard, with one click.
| Through somebody else's cloud | Straight through your own machine |
|---|---|
| Donor taps a card | Donor taps a card |
| The supplier's cloud | Your computer, in the masjid |
| Their monthly fee — busy month or quiet one | Your own Stripe account |
| The gift, less the processor's fee | No monthly fee, in any month |
| The gift, less the processor's fee | |
| Donor records live in their system. If you leave, you ask for them back. | Donor records stay on your machine. There is no middle to leave. |
OpenMasjidOS is the base. Everything else is an app you install onto it from the App Store — its own repo, its own Docker container, its own data. Updating the platform never touches your apps.
| Repository | What it is |
|---|---|
| OpenMasjidOS | The platform. One-line install, a login-protected dashboard with live system status, a one-click App Store, file manager, terminals and backups. Think umbrelOS, built for masjids. |
| OpenMasjidAPPS | The app catalog OpenMasjidOS reads to populate the App Store. Start here if you want to build an app or list one. |
| OpenMasjidDisplay | Every TV in the masjid, driven from one small computer over RTSP — prayer timetables designed in a live editor, IP and imam cameras, HDMI sources, schedules, and a PIN-protected page so a volunteer can switch a screen from their phone. |
| OpenMasjidDonations | Your own branded donation website on your own Stripe account. Campaigns with clean links, one-time or monthly giving, QR codes, a full ledger with CSV export, and an optional Cloudflare Tunnel for public access. |
| OpenMasjidKiosk | A wall-mounted Android tablet and a Stripe Reader M2 become a tap-to-give station at the door. Pair a tablet with a 6-digit code; it locks into full screen and only a PIN gets out. |
| OpenMasjidStudents | The madrasa's tuition desk. Households, fee plans, invoicing and an append-only ledger, with a phone-first parent portal, saved cards and autopay — and a Student ID that lets a parent pay at the kiosk or on the donation site without an account. |
Browse the whole catalog at openmasjidsolutions.org/apps.
- Free, forever. Every masjid gets every part of it. There is no upsell, because there is nothing to sell.
- Open source. AGPL-3.0 — anyone can read the code and improve it, and those improvements come back to every masjid.
- Your hardware, your data. A Raspberry Pi, a mini-PC or a Proxmox container at the masjid. Nothing is uploaded to us.
- One-click App Store. Browse the catalog from the dashboard, install, and the app asks for what it needs.
Running a masjid? Start at openmasjidsolutions.org/get-started — it walks through the hardware, the install and the first app. The docs cover the rest, and there's help if you get stuck.
Building on it? Every repo is a TypeScript monorepo that runs as one Docker container. Start with
OpenMasjidAPPS (docs/BUILDING_AN_APP.md) for the app contract, and
docs/APP_MANIFEST_SPEC.md for the platform side.
Volunteers, imams and developers are in the Discord every day — asking questions, testing releases, and deciding what gets built next. Come and say salaam.
You don't have to write code to help. Testing a release in a real masjid, writing docs, translating the interface, or telling us what your committee actually needs are all worth a great deal. See how to help and the contributing guide.
Contributions are made under AGPL-3.0 plus a Contributor License Agreement, signed automatically on your first pull request. It lets the project offer commercial licenses to organisations that can't accept AGPL — the public tree always stays AGPL-3.0.
Created by Hasan Ismail, with immense help from Qari Ijaz (project manager) and Osman Sayed (lead developer).
Resources for this project were generously sponsored by An-Noor Institute, Rihlatul Ilm Foundation, and AsmaTec Inc.
May Allah reward everyone who made it possible.
Website · Discord · Docs · Support us
Free, forever, for every masjid. · The software is AGPL-3.0
