Skip to main content

How to setup Mawaqit on the Raspberry pi

Ymane A avatar
Written by Ymane A
Updated over a week ago

You can easily set up MAWAQIT on your Raspberry Pi 4 by following the steps below:


Step 1: Prepare Your Installation Files

  1. Download the MAWAQIT system image from our official source.

  2. Connect your microSD card to your computer (either through the built-in card reader or a USB SD card adapter).

  3. Download and install the Etcher software on your computer.

  4. Flash the mawaqit.xz system image onto your microSD card using Etcher.

Congratulations!
You have successfully installed the MAWAQIT system image onto your Raspberry Pi memory card.

Now, simply insert the microSD card into your Raspberry Pi 4, connect it to a TV screen via HDMI, and proceed with the activation steps below.


Step 2: Configure Your Raspberry Pi

  1. Start the Raspberry Pi and connect a USB keyboard and mouse.

  2. Minimize the MAWAQIT window by pressing the F11 key on your keyboard.

  3. Connect to the Internet (via Wi-Fi or Ethernet).

    • You can also use your smartphone’s hotspot if needed.

    • Internet access is only required for the initial synchronization and will not be needed afterward.

  4. Synchronize the MAWAQIT app with your account — follow the on-screen instructions to complete the setup.

  5. After validating the synchronization form, your MAWAQIT prayer times display will appear.

  6. Press F11 again to maximize the MAWAQIT window and enjoy your live display.


Important Note

The Raspberry Pi does not include an RTC (Real-Time Clock) — a component with a small battery that keeps accurate time when the device is powered off.

If you do not plan to keep your Raspberry Pi connected to the Internet, we strongly recommend adding an RTC module.
This will prevent the system clock from resetting after a power outage.

Simply plug in the RTC module as illustrated below:

Did this answer your question?