Skip to content

Releases: OpenMasjid-Solutions/OpenMasjidOS

Release list

v0.7.0

v0.7.0 Pre-release
Pre-release

Choose a tag to compare

@hasan-ismail hasan-ismail released this 20 Jun 05:23

OpenMasjidOS v0.7.0

The first public build of OpenMasjidOS — a free, self-hosted platform that gives your masjid a beautiful, login-protected dashboard for installing and managing apps on your own hardware. One command to install, no technical knowledge needed.

This is an early pre-release. The foundations are here and working; expect a few rough edges while the app catalog and remaining polish land. Feedback and bug reports are very welcome.

Install / update

curl -fsSL https://raw.githubusercontent.com/hasan-ismail/OpenMasjidOS/master/install.sh | bash

When it finishes, open http://openmasjidos.local (or http://<your-server-ip>) on any device on the same network and create your admin account.

Re-run the same command at any time to Update, Repair, or Remove — updating and repairing only ever touch the OpenMasjidOS core, never your installed apps or their data.

What's included

Core platform

  • One-command installer that sets up Docker, runs OpenMasjidOS as a service that survives reboots, and prints your access URL. Works on amd64 and arm64 across Ubuntu, Debian, Raspberry Pi OS, Fedora, and Rocky/Alma.
  • Reachable at openmasjidos.local on your network, or by IP.
  • All data kept under /opt/openmasjid/, with every app isolated in its own Docker container.

Dashboard

  • Login-protected, with a one-step admin account created on first run.
  • Live system status — CPU, memory, storage, temperature, uptime, and running-app count, all updating in real time.
  • App tiles you can open, restart, shut down, or remove, plus a dock you can pin apps to.
  • A built-in file manager for browsing, uploading, downloading, renaming, and deleting files.
  • A polished, themeable interface: dark or light mode, accent colours, a choice of wallpapers (or your own image), and gentle animation.

For advanced volunteers (Settings → Advanced — all off by default)

  • Add CasaOS-compatible community app stores and install apps from them.
  • Install anything by pasting a Docker Compose file, with the platform checking it for risky settings first.
  • Open a terminal into any app, or a root terminal into OpenMasjidOS itself.
  • Add an SSH key for logging into the machine.

Maintenance

  • Update / Repair / Remove, all from the same install command.
  • One-file backups from Settings → Advanced (or a tar of /opt/openmasjid).
  • Admin password reset from the server terminal — no data is lost.

Requirements

  Minimum Recommended
RAM 1 GB 2 GB
Storage 8 GB free 32 GB
Architecture amd64 / arm64
Internet Required

Docker is installed automatically if it isn't already present. Step-by-step guides for Raspberry Pi, Proxmox VE, and bare-metal Linux are in the README.

Coming soon

  • The OpenMasjidAPPS catalog — the official one-click App Store built for masjids. Until it lands, you can install apps via community stores or a pasted Compose file.
  • Right-to-left support for Arabic and Urdu.

Notes

  • Licensed under AGPL-3.0 — free to use, modify, and share. If you deploy a modified version as a network service, you publish your source under the same license, so improvements made by one masjid benefit them all.
  • Found a bug or have an idea? Please open an issue: https://github.com/hasan-ismail/OpenMasjidOS/issues

First release. Thank you for trying OpenMasjidOS this early.

# OpenMasjidOS v0.7.0

The first public build of OpenMasjidOS — a free, self-hosted platform that gives your masjid a beautiful, login-protected dashboard for installing and managing apps on your own hardware. One command to install, no technical knowledge needed.

This is an early pre-release. The foundations are here and working; expect a few rough edges while the app catalog and remaining polish land. Feedback and bug reports are very welcome.

Install / update

curl -fsSL https://raw.githubusercontent.com/hasan-ismail/OpenMasjidOS/master/install.sh | bash

When it finishes, open http://openmasjidos.local (or http://<your-server-ip>) on any device on the same network and create your admin account.

Re-run the same command at any time to Update, Repair, or Remove — updating and repairing only ever touch the OpenMasjidOS core, never your installed apps or their data.

What's included

Core platform

  • One-command installer that sets up Docker, runs OpenMasjidOS as a service that survives reboots, and prints your access URL. Works on amd64 and arm64 across Ubuntu, Debian, Raspberry Pi OS, Fedora, and Rocky/Alma.
  • Reachable at openmasjidos.local on your network, or by IP.
  • All data kept under /opt/openmasjid/, with every app isolated in its own Docker container.

Dashboard

  • Login-protected, with a one-step admin account created on first run.
  • Live system status — CPU, memory, storage, temperature, uptime, and running-app count, all updating in real time.
  • App tiles you can open, restart, shut down, or remove, plus a dock you can pin apps to.
  • A built-in file manager for browsing, uploading, downloading, renaming, and deleting files.
  • A polished, themeable interface: dark or light mode, accent colours, a choice of wallpapers (or your own image), and gentle animation.

For advanced volunteers (Settings → Advanced — all off by default)

  • Add CasaOS-compatible community app stores and install apps from them.
  • Install anything by pasting a Docker Compose file, with the platform checking it for risky settings first.
  • Open a terminal into any app, or a root terminal into OpenMasjidOS itself.
  • Add an SSH key for logging into the machine.

Maintenance

  • Update / Repair / Remove, all from the same install command.
  • One-file backups from Settings → Advanced (or a tar of /opt/openmasjid).
  • Admin password reset from the server terminal — no data is lost.

Requirements

Minimum Recommended
RAM 1 GB 2 GB
Storage 8 GB free 32 GB
Architecture amd64 / arm64
Internet Required

Docker is installed automatically if it isn't already present. Step-by-step guides for Raspberry Pi, Proxmox VE, and bare-metal Linux are in the [README](https://github.com/hasan-ismail/OpenMasjidOS#installation-guide).

Coming soon

  • The OpenMasjidAPPS catalog — the official one-click App Store built for masjids. Until it lands, you can install apps via community stores or a pasted Compose file.
  • Right-to-left support for Arabic and Urdu.

Notes

  • Licensed under AGPL-3.0 — free to use, modify, and share. If you deploy a modified version as a network service, you publish your source under the same license, so improvements made by one masjid benefit them all.
  • Found a bug or have an idea? Please open an issue: https://github.com/hasan-ismail/OpenMasjidOS/issues

First release. Thank you for trying OpenMasjidOS this early.