OpenMasjid Docs
Home
GitHub
Home
GitHub

Install in a Proxmox container

What you need

Time: 25 minutes

  • A Proxmox host that already works, and the password for its web page.
  • About 10 GB of free disk space on that host.
  • No new hardware. No account with anybody.

A container here is a small, separate Debian computer that runs on your Proxmox host. It has its own address on your network. OpenMasjidOS runs inside it and cannot disturb anything else on the host.

Step 1 — Get the Debian template

  1. Open the Proxmox web page and sign in.
  2. In the tree on the left, click your node, then local (storage).
  3. Click CT Templates, then Templates.
  4. Search for debian-12-standard.
  5. Select it, then click Download.
Result:

A task window opens and closes. debian-12-standard now appears in the CT Templates list.

Step 2 — Create the container

Click Create CT at the top right, then use these settings.

Tab Setting Value
General Hostname openmasjid
General Unprivileged container ticked
General Password set one, and write it down
Template Template debian-12-standard
Disks Disk size 10 GB
CPU Cores 2
Memory Memory 2048 MB
Memory Swap 512 MB
Network IPv4 DHCP
DNS leave as the host's

One setting is not on those tabs, and OpenMasjidOS does not start without it. The container runs Docker, and Docker needs nesting.

  1. Finish the wizard, but do not start the container yet.
  2. Click the new container in the tree, then click Options.
  3. Double-click Features.
  4. Tick Nesting, then click OK.
  5. Click Start, then click Console.
Result:

A black console window opens and shows openmasjid login:.

Step 3 — Prepare the container

Sign in at the console. The username is root. The password is the one you set in step 2.

Update the container first.

apt update && apt full-upgrade -y
Result:

A list of packages scrolls past. The prompt returns when it finishes.

Debian containers ship without curl. Install it.

apt install -y curl
Result:

Setting up curl appears near the end, then the prompt returns.

Find the container's address. You need it in step 5.

hostname -I
Result:

One address, such as 192.168.1.50. Write it down.

Step 4 — Run the installer

You are already root in a container, so this command needs no sudo. Copy the whole line. It is one command.

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

The installer shows a menu. Press Enter to accept Install.

Result:

The installer works through six steps, and names each one. It installs Docker, downloads OpenMasjidOS, and starts it. This takes 5 to 10 minutes. It then prints a box with the address to open.

Step 5 — Open the dashboard

Type https:// and then the address from step 3 into a browser on your network.

Result:

Your browser says Not secure, or Your connection is not private. This is expected. Click Advanced, then Proceed. You do this once on each device.

Checkpoint

You can open https:// followed by the container's address, and you see the screen that says Welcome to OpenMasjidOS.

Next, create your admin account.

If something goes wrong

What you seeWhyWhat to do
The installer fails while it installs Docker.Nesting is off. Docker cannot run inside the container without it.Stop the container. Open Options, then Features, then tick Nesting. Start it and run the installer again.
curl: command not foundThe Debian container template ships without curl.Run apt install -y curl, then run the installer again.
The build or the install is killed with no message.The container is short of memory.Raise Memory in Proxmox to 2048 MB or more, restart the container, then run the installer again.
hostname -I prints nothing.The container has no address yet.Check that Network IPv4 is set to DHCP, then restart the container.
On this page