Your admin account
What you need
Time: 10 minutes
- OpenMasjidOS installed, and the admin account created.
If you have not created the account yet, do that first in Open it for the first time.
What this account can do
The admin account is not only a login for a website. It can install software on the masjid computer, remove it, read the logs, and open a terminal on the machine itself.
Who should hold it
There is one admin account in this version. More accounts, with different levels of access, are planned.
Until then, two people must know the password.
- One person who runs it. Usually the volunteer who installed it.
- One trustee who keeps a copy. They do not need to use it. They need to be able to reach it if the first person moves away.
The email address is not your login
The setup screen asked for two different things, and they are easy to confuse.
| Field | What it is for |
|---|---|
| Your name | Your username. You sign in with this. |
| Where OpenMasjidOS sends alerts, such as an app going offline. |
The sign-in screen says Email or username, so either works to sign in. The email exists so that the software can reach a person when something breaks.
Change the password
- Click Settings in the dashboard.
- Find Account, then Change password.
- Enter the current password, then the new one.
- Click the button to save.
The dashboard shows Your password has been updated.
If nobody knows the password
You do not lose the masjid's data. You need access to the machine itself, either sitting at it or over SSH.
- Sign in to the masjid computer as
root. - Run the command below.
- Follow the prompts to set a new password.
The command asks for a new password and confirms it. Your apps and their data are untouched.
There is a second, larger option for a machine you have just restored onto. Re-run the installer and choose Reset sign-in. That sets a new password, signs everybody out, and re-links the apps. It keeps all data.
Checkpoint
Two people can reach the admin password, and you have signed in once with it after changing it.
If something goes wrong
| What you see | Why | What to do |
|---|---|---|
| The password is correct but sign-in fails. | Repeated wrong attempts are slowed down on purpose. | Wait a minute, then try once more, carefully. |
| reset-password.js says there is no such container. | OpenMasjidOS is not running. | Re-run the installer and choose Repair, then try the command again. |