> For the complete documentation index, see [llms.txt](https://kb.mago.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.mago.io/mago-stage/mago-stage-client-apps/install-mago-stage.md).

# Install Mago Stage

Install the Mago Stage application that matches the device’s platform and intended role.

Only install packages obtained from the Mago Stage Administration Portal, an approved app store, or the organization’s managed software-distribution system.

### Choose the correct application

| Platform        | Controller | Receiver | Distribution                                         |
| --------------- | ---------- | -------- | ---------------------------------------------------- |
| Windows         | Yes        | Yes      | Administration Portal or managed software deployment |
| Android         | Yes        | Yes      | Administration Portal or managed software deployment |
| iPhone and iPad | Yes        | No       | Apple App Store or managed Apple deployment          |
| macOS           | No         | Yes      | Administration Portal or managed software deployment |
| Web browser     | Yes        | Yes      | No local installation required                       |

Controller and receiver packages are not interchangeable. Confirm the intended device role before downloading an installer.

### Download from the Administration Portal

When software downloads are available through the organization’s Administration Portal:

1. Sign in to the Administration Portal.
2. Select **Downloads**.
3. Find **Mago Stage**.
4. Select the required platform.
5. Select the **Controller** or **Receiver** package.
6. Review the published version.
7. Select **Download**.
8. Review the changelog when available.
9. Follow the platform-specific installation instructions below.

The packages shown on the Downloads page depend on the selected environment and the releases published by the organization.

### Install on Windows

1. Download the appropriate Windows controller or receiver package.
2. Close any running instance of Mago Stage.
3. Open the downloaded installer.
4. Approve the operating-system security prompt when requested.
5. Follow the installation instructions.
6. Open Mago Stage after installation.
7. Confirm that the expected Controller or Receiver experience opens.

Administrator approval may be required depending on the organization’s Windows policies.

If Windows blocks the installer, confirm that:

* The installer came from the approved Mago Stage download location.
* The package has not been modified.
* The device permits installation of organization-approved applications.
* Endpoint security has not quarantined the package.

Do not bypass an organization security warning without approval from the IT administrator.

### Install on Android

Android controller and receiver packages are distributed separately.

1. Download the required Android package from the approved source.
2. Select the Controller or Receiver package for the device’s intended role.
3. Open the downloaded package.
4. Approve the installation when prompted.
5. Open Mago Stage after installation.
6. Grant permissions required for the intended features.

When the package is installed directly rather than through a managed application store, Android may request permission to install applications from that source.

Only enable this permission for an organization-approved download source. Disable it again after installation when required by the organization’s security policy.

For managed deployments, the organization can distribute the application through its mobile-device-management or enterprise-mobility platform.

### Install on iPhone or iPad

Mago Stage on iPhone and iPad supports the controller role.

1. Open [Mago Stage on the Apple App Store](https://apps.apple.com/us/app/mago-stage/id6742988201).
2. Select **Get** or the download button.
3. Complete Apple authentication when prompted.
4. Open Mago Stage.
5. Grant the permissions required for the intended features.

An organization can also distribute the application through its managed Apple deployment system.

Mago Stage is optimized for iPad. The iPhone application supports selected workflows with a more compact interface.

### Install on macOS

Mago Stage on macOS supports the receiver role.

1. Download the macOS receiver package from the approved source.
2. Open the downloaded disk image.
3. Move Mago Stage to the **Applications** folder when prompted.
4. Open Mago Stage from **Applications**.
5. Approve the operating-system security prompt when requested.
6. Grant the permissions required for receiver operation.

If macOS prevents the application from opening, confirm that:

* The package was obtained from the approved download location.
* The download completed successfully.
* The device permits organization-approved applications.
* The installed release is signed and notarized.
* Endpoint security has not quarantined the application.

Do not disable macOS security controls to install an unverified package.

### Use Mago Stage in a browser

A browser-based Mago Stage experience does not require local installation.

1. Open a supported browser.
2. Go to the address supplied by Mago or the organization administrator.
3. Allow pop-up windows when required.
4. Sign in when prompted.
5. Grant screen-sharing, camera, or microphone permission when using the related feature.

Browser capabilities depend on the operating system and browser.

Screen capture is not supported from mobile browsers or Safari on iPhone and iPad. Use the native Mago Stage application for supported mobile sharing workflows.

### Managed deployment

Organizations can deploy Mago Stage through supported software-management tools.

Before a managed rollout:

* Select the correct controller or receiver package.
* Confirm the target operating system.
* Confirm the application version.
* Test installation on a representative device.
* Test upgrades from the currently deployed version.
* Configure required application permissions.
* Confirm firewall and proxy access.
* Define how devices will receive future updates.
* Avoid installing controller and receiver packages on the wrong device group.

### Confirm the installation

After installation:

1. Open Mago Stage.
2. Confirm that the application starts without an error.
3. Confirm that the intended Controller or Receiver role appears.
4. Confirm that the application version matches the approved release.
5. Confirm that the device can reach the required Mago Stage services.
6. Continue with selecting the correct service environment.

Do not activate a receiver or sign in until the application is connected to the correct Mago Cloud or on-premises environment.
