Installing on macOS

Who this page is for

Anyone installing al-Shamil on a Mac for the first time, or updating it to a newer version.

What you need first

  • The download link from the support team. The file is named Shamil-<version>.dmg (for example Shamil-0.1.1.dmg), with a .sha256 file beside it for anyone who wants to verify the download.
  • macOS 13 (Ventura) or newer. One application runs on both Apple Silicon and Intel.

Steps

  1. Download the DMG file and open it with a double click.

  2. Drag the Shamil icon into the Applications folder shown next to it.

  3. Close the window and eject the disk image (click the eject symbol next to its name in Finder).

  4. Open the application from the Applications folder. The first open is refused — this is expected, because the trial build is not signed by Apple:

    Diagram: the first open on a Mac

    • Try opening it once and let the message appear.
    • Open System Settings → Privacy & Security, scroll until you find the mention of Shamil, press Open Anyway and confirm.
    • On versions older than macOS 15, a right click on the application and then Open is enough.

What you see next

The sign-in window, with the language list in case you want to change it before signing in. Continue in Signing in.

Updating to a newer version

Download the new DMG and drag the application into Applications over the old one. Your settings stay as they are, and all your data is on the server, so nothing is lost.

Common mistakes

  • Running the application from inside the DMG window instead of dragging it to Applications: it works once and then its icon disappears. Drag it to Applications first.
  • Expecting it to open on the first click. The first refusal is normal; the Open Anyway step is needed only once per version.
  • Taking the security warning for a virus. The warning appears because the trial build is unsigned, not because anything is wrong with the file. For peace of mind, compare the output of shasum -a 256 with the accompanying .sha256 file.