> 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/activate-a-receiver.md).

# Activate a receiver

A receiver must be activated before controllers can connect to it.

Activation registers the receiver with an organization and creates its display record in the Administration Portal. This is normally completed once when the receiver is first installed or moved to a different Mago Stage environment.

### Who can activate a receiver

Activation requires a user with permission to manage displays in the Administration Portal.

If you do not have this permission, leave the activation code visible and give it to the appropriate administrator.

### Before activation

Confirm that:

* Mago Stage is installed as a receiver.
* The receiver is connected to the correct Mago Stage environment.
* The receiver has a working network connection.
* The administrator can access the Administration Portal.
* The correct organization is selected in the Portal.
* An appropriate display license is available when required.

See **Select the Mago Stage environment** if the receiver is connected to the wrong server.

### Get the activation code

1. Open Mago Stage on the receiver.
2. Wait while the receiver connects to the selected environment.
3. Leave the activation screen open.
4. Note the six-character activation code shown on the display.

The activation code can contain uppercase letters and numbers.

Use the code currently shown by the receiver. If the receiver generates a new code, the previous code may no longer be accepted.

<figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2FR1DWeW2fs9Iob63SPNWQ%2Fimage.png?alt=media&amp;token=8e936897-106b-470f-bec9-8d63540c2758" alt=""><figcaption></figcaption></figure>

### Activate the receiver in the Administration Portal

1. Sign in to the Mago Stage Administration Portal.
2. Select the correct organization.
3. Select **Displays**.
4. Select **Activate**.
5. Under **Enter activation code**, enter the six-character code shown by the receiver.&#x20;

   <figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2Fuq3DUGGOgAl1UljpZmGf%2Fimage.png?alt=media&amp;token=32050ee7-70fb-479c-98ed-feea0b7c6bb1" alt=""><figcaption></figcaption></figure>
6. Select **Continue**.
7. Assign an available display license when the Portal requests one.&#x20;

   <figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2FYt3riizRTzegdHklsNzg%2Fimage.png?alt=media&amp;token=c9c9961a-a5c3-4299-8b0d-83b4a54e9d72" alt=""><figcaption></figcaption></figure>
8. Select **Activate Display**.
9. Enter a name that identifies the display’s location or purpose.&#x20;

   <figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2Fa0waUlKHqfErMHMOcD5E%2Fimage.png?alt=media&amp;token=473fc42b-2e89-4e57-8350-fa4415f2b726" alt=""><figcaption></figcaption></figure>
10. Select **Continue**.

Example display names include:

* Boardroom Display
* Reception Screen
* Training Room
* Showroom Left Display

You can select **Skip** when the existing or automatically assigned name is suitable.

When **Display activated** appears, select **Finish**.

### Confirm activation

After activation:

* The new display appears under **Displays** in the Administration Portal.
* The receiver checks its activation status automatically.
* The receiver leaves the activation screen.
* The receiver displays its controller connection screen.
* Controllers can connect using the displayed QR code or connection code.

Leave the receiver online while it checks for approval.

<figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2FTjWh6hsc5mfr7Pyx4gnu%2Fimage.png?alt=media&amp;token=d7eb1aad-feb8-4a1f-ad07-add09d14895a" alt=""><figcaption></figcaption></figure>

### If no display license is available

If the Portal reports that no display seats are available, the organization does not have a suitable active license with available capacity.

An administrator must review the organization’s licenses and assignments before activation can continue.

Do not assume that deleting a display automatically releases its license assignment. Review the license and assignment status in the Administration Portal.

After capacity becomes available:

1. Return to **Displays**.
2. Select **Activate**.
3. Enter the receiver’s current activation code.
4. Repeat the activation process.

### Move a receiver to another environment

Receiver activation belongs to a specific Mago Stage environment.

If the receiver is moved from Mago Cloud to an on-premises environment, or between corporate servers:

1. Select the new environment on the receiver.
2. Wait for the receiver to display a new activation code.
3. Activate the receiver in the new environment’s Administration Portal.
4. Assign a license when required.

Activation records and licenses are not transferred automatically between environments.

### Troubleshooting

#### The activation code is rejected

Confirm that:

* All six characters were entered correctly.
* The receiver is still displaying the same code.
* The receiver and Portal use the same Mago Stage environment.
* The correct organization is selected.

If the receiver displays a new code, use the new code.

#### Activate is unavailable

Confirm that:

* Your account has permission to manage displays.
* The correct organization is selected.
* The server license is active for an on-premises deployment.
* The Portal is not restricted by an unresolved licensing warning.

#### No display seats are available

Ask an administrator to review:

* Active display licenses
* License expiration
* Available capacity
* Existing display assignments
* Deleted-receiver assignments that may still count toward license totals

Return to activation after suitable capacity is available.

#### The display is already assigned

The receiver may already be associated with another organization or license assignment.

An administrator must review and resolve the existing assignment before the receiver can be activated elsewhere.

#### The receiver remains on the activation screen

Confirm that:

* The receiver remains online.
* The receiver and Portal use the same environment.
* The activation completed successfully in the Portal.
* The receiver can reach the Mago Stage API.
* The system date and time are correct.

Wait briefly for the automatic activation check. If the receiver does not continue, restart the application and confirm its environment again.

#### The receiver shows a server error

Confirm that the correct environment is selected. If the receiver uses a corporate server, ask the administrator to verify that the server is running and reachable.
