— home

Get started

Getting it running at your masjid

One small computer, one afternoon, and one willing person. There is nothing to sign up for, no card to enter, and no decision here that costs money.

  • Free forever, not a trial
  • Runs at the masjid, not on our servers
  • No account, no card, nothing to cancel

What it takes

Three things, and none of them are complicated

This is the whole list. If your masjid has these, it can run its own software.

One small computer

A mini-PC is ideal — about the size of a hardback book, silent, and cheap second-hand. It sits in the office and stays switched on. A spare PC or laptop works to try it out.

A network cable to it

It plugs into your router or a network socket, the same as a printer. It does not need to be reachable from the internet, and nothing on your router changes.

One willing person

Somebody who can follow written steps carefully for an afternoon. No experience with servers, no coding, and nothing to learn beforehand. Or somebody else can do it for you — see below.

You do not need to understand servers, networks or code — and once it is running, you use a web page like any other, on your phone or a laptop.

How to get there

Three ways, and two of them are free

Every route ends at the same place, with the same software. Pick by how much of it you want to do yourselves.

Free

Do it yourself

An afternoon

Follow the guides. They assume nothing, name every button, and tell you after each step what you should be seeing — so you always know whether it worked.

Open the guides
Free

Do it with company

An afternoon, with someone on hand

Start the guides and keep the Discord open beside them. The people who wrote this are in there, and other masjids who have already done it are too. Ask before you get stuck, not after.

Join the Discord
Paid

Have it done for you

You plug it in

Our partner AsmaTec Inc. tells you exactly what to buy, ships the machine already set up with your masjid's details in it, and stays with you until everything works. Optional maintenance afterwards.

What that includes

Whichever route you take, this is the whole install

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)"

It asks nothing while it runs, and prints the address to open when it finishes. The guides walk through it a step at a time, with a picture of what you should see.

Starting on your own and asking for help later is normal, and so is starting on your own and handing it to AsmaTec Inc. halfway. Nothing you do in one route is wasted in another.

The OpenMasjidOS App Store: a row of apps, each with an icon, a name, a short description and a one-click Install button — a prayer display, a donations site, a giving kiosk and madrasa fees.
The App Store, on the day it is running. Each app installs with one click and asks for what it needs.

What you supply

Three accounts in the masjid's own name

This is the difference between running it yourself and paying a monthly fee. There is no plan to select and nothing to unlock. You supply three things of your own, one time, and every feature a hosted platform charges for is then available. All three are free to open, and all three stay yours.

  1. Thing 1: Your Stripe keys

    Paste them once and the donation site, the kiosk and madrasa tuition all take card payments — into the masjid’s own Stripe account, which we never touch. You can add more than one, so Zakat lands separately from the general fund.

  2. Thing 2: A Cloudflare tunnel and your domain

    Paste a tunnel token and your domain and the donation page is live on the internet over HTTPS, with no port forwarding and nothing exposed on your router. Only the app pages go out — the dashboard stays on your own network.

  3. Thing 3: Email, by SMTP or Resend

    Set one of them up in Settings → Email and send yourself a test. Every app sends its receipts and alerts through it afterwards, without ever handling the password itself.

You set each one on the platform, not in each app. An app you install later can then send email and take a card payment straight away. You never configure it again, and the app never sees the credentials.

See what it will run

Prayer displays on every screen, a donation page on your own domain, a giving kiosk by the door, and madrasa fees. All of them free, all of them one click.