> 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/before-you-begin.md).

# Before you begin

Before installing or configuring Mago Stage, confirm which device role, service environment, account, and permissions you will use.

#### Choose the device role

Determine whether the device will act as a controller or receiver.

* A **controller** is used to create and manage Stages, add content, connect displays, and control presentations.
* A **receiver** displays content sent from a controller.

Some platforms support both roles. See **Supported platforms** for platform availability.

#### Check the device

Confirm that the device meets the applicable requirements:

* Supported operating system or browser
* Sufficient processor, memory, and storage
* Suitable display resolution
* Current operating-system and graphics updates
* Reliable network connection
* Required camera, microphone, or screen-sharing capabilities

See **Controller requirements** or **Receiver requirements** for details.

Mago Stage mobile controllers are optimized for tablets. Phone-sized controllers support selected workflows but provide a more limited working area.

#### Identify the service environment

Mago Stage can connect to:

* Mago Cloud
* A self-hosted or on-premises environment

Use the service environment specified by your administrator.

For an on-premises environment, obtain the exact server address before setup. Include `https://` where applicable.

Accounts, receivers, Stages, and configuration belong to the selected environment. Changing environments signs the user out and may make content from the previous environment unavailable until the device reconnects to it.

#### Prepare the user account

Depending on the organization’s configuration, users may sign in with:

* An organization-created email address and password
* Microsoft single sign-on
* Google single sign-on
* Apple single sign-on
* Another identity provider configured by the organization

Obtain the required account or invitation from the organization administrator.

The available sign-in methods depend on the selected Mago Stage environment and the organization’s authentication policies.

#### Prepare the receiver

Before a controller can use a receiver, the receiver must normally be:

* Installed on a supported device
* Connected to the correct Mago Stage environment
* Activated in the Administration Portal
* Assigned an available display license
* Online and reachable
* Connected to the intended display and audio equipment

An organization administrator may be required to complete receiver activation.

#### Prepare the controller

Before connecting to a receiver, confirm that the controller:

* Uses the same Mago Stage environment as the receiver
* Has a working network connection
* Can sign in when authentication is required
* Can reach the receiver through the Mago Stage service
* Has permission to use the intended features

The controller and receiver do not need to be on the same local network when permitted by the active license, routing configuration, and organization policies.

Basic requires the Mago Stage server and receiver to run on the same Windows machine. Pro supports receivers available on the private network. Ultra and Cloud can support local or remote receivers, subject to the applicable server and network configuration.

Both devices must be able to reach the same Mago Stage environment.

#### Prepare cloud accounts

A connected Microsoft 365 or Google account is required only when using supported cloud files, folders, profiles, or calendar features.

Before connecting an account, confirm that:

* The provider is enabled by the organization.
* The account is permitted to use third-party applications.
* Required administrator consent has been granted.
* The user has access to the intended files or folders.
* Organization sharing policies permit the intended workflow.

Cloud accounts can be connected after signing in to Mago Stage.

#### Prepare application permissions

Mago Stage requests permissions only when the related feature is used.

| Permission                            | Required for                                                   |
| ------------------------------------- | -------------------------------------------------------------- |
| Local network                         | Finding and communicating with displays on supported platforms |
| Camera                                | QR-code scanning, photographs, document scanning, and video    |
| Microphone                            | Audio and conferencing                                         |
| Photos or media library               | Selecting photographs and videos                               |
| Files or storage                      | Selecting and saving local content                             |
| Screen recording or screen capture    | Sharing the controller’s screen                                |
| Notifications                         | Supported status, update, or session notifications             |
| Prevent sleep or background operation | Continuous receiver operation and supported sharing workflows  |

Permission names vary by operating system.

If a permission is denied, the related feature may remain unavailable until access is enabled in the device settings.

#### Check the network

Confirm that:

* Required Mago Stage services are reachable.
* DNS resolves the required service addresses.
* HTTPS and secure WebSocket connections are permitted.
* The connection is stable enough for the intended content.
* Screen sharing and conferencing traffic are permitted when those features are used.
* A fixed receiver uses wired Ethernet where practical.

See **Network requirements** for detailed connectivity guidance.

#### Information to collect

Before beginning setup, collect the applicable information:

| Information                         | Needed for                                    |
| ----------------------------------- | --------------------------------------------- |
| Mago Stage environment              | All installations                             |
| Corporate server address            | On-premises deployments                       |
| User email address                  | Account sign-in                               |
| Temporary or existing password      | Password-based sign-in                        |
| Identity provider                   | Single sign-on                                |
| Receiver activation code            | Registering a new receiver                    |
| Available display license           | Receiver activation                           |
| Receiver connection code or QR code | Connecting a controller                       |
| Microsoft or Google account         | Cloud content and connected features          |
| Required application permissions    | Camera, microphone, files, and screen sharing |

After these requirements are ready, continue with the installation and setup instructions for the intended controller or receiver.
