Install your first app
What you need
Time: 10 minutes
- You are signed in to the dashboard.
- The masjid computer can reach the internet.
OpenMasjidOS on its own does very little. The apps do the work: prayer timetables on your screens, a donation page, madrasa fees. This page is how you get one.
Step 1 — Open the App Store
Click App Store at the top of the dashboard.
A grid of apps, each with an icon, a name and one line describing it.
Step 2 — Install one
- Click the app you want.
- Read the description, then click Install.
- Wait. The button changes as it works.
The app downloads and starts. This takes one to five minutes the first time. The button then reads Installed, and the app appears on your dashboard.
Step 3 — Open it
Go back to Dashboard and click Open on the app's card.
The app opens, already signed in as you. It matches your dashboard's light or dark theme.
What every button on the card does
| Button | What it does |
|---|---|
| Open | The app's own screen. |
| Turn off | Stops the app. Everything it has saved stays. |
| Start | Starts it again. |
| App options | The three-dot menu, with the rest of these. |
| View logs | What the app is printing. Useful to paste into Discord. |
| Check for update | Offers a newer version if there is one. Data is kept. |
| Pin to dock | Puts it in the row of small icons. Changes nothing else. |
| Remove | Uninstalls it. See the caution below. |
Removing an app
Removing asks two separate questions, and the difference matters.
- Open App options, then click Remove.
- A dialog asks Remove {app}? and says it turns the app off and takes it off your dashboard.
- There is a separate tick box: Also delete this app's data (cannot be undone).
- Leave that box UNTICKED unless you are certain.
- Click Remove app.
Which app to install first
| If you want | Install |
|---|---|
| Prayer times on the TVs | OpenMasjid Display |
| A donation page people can use from home | OpenMasjid Donations |
| A tap-to-give tablet at the door | OpenMasjid Kiosk |
| Madrasa fees and invoices | OpenMasjid Students |
Display is the easiest first app, because it needs no outside account. Install it, open it, and you have something to show the committee in ten minutes.
Checkpoint
An app appears on your dashboard, its card says it is running, and clicking Open signs you straight in without asking for another password.
If something goes wrong
| What you see | Why | What to do |
|---|---|---|
| The App Store is empty. | The masjid computer cannot reach the internet. | Check the network cable and that the machine has internet. Then refresh the page. |
| Install fails part way through. | Usually the download was interrupted. | Click Install again. It carries on from what it already has. |
| The app installed but the card says it is not running. | It started and then stopped. | Open App options, then View logs, and read the last lines. Paste them into Discord if they do not explain it. |
| Open asks me to sign in again. | The app cannot reach the dashboard, usually after the machine changed address. | Open Settings, then Network, then click Reconnect apps. |