# Install package

AppControl is delivered as a Mendix application package (.MDA file). To use AppControl you will need to download the package and deploy it to a licensed Mendix Cloud node or a Mendix server running in your private cloud.

<details>

<summary>Step 1: Prerequisites</summary>

Before installing AppControl make sure you have the following:

* A licensed Mendix Cloud (minimum size 'S', preferably size 'M') or private cloud node where you can deploy the AppControl package.
* If you have firewalls between the node where you will deploy AppControl and the Internet, make sure the following ports are open:
  * <https://teamserver.sprintr.com:443>
  * <https://svn.home.mendix.com:443>
  * <https://git.api.mendix.com:443>
  * <https://deploy.mendix.com:443>
  * <https://support.bluestorm.io:443>
* A registered account in the Blue Storm Customer Portal. This will be provided to you by Blue Storm.

</details>

<details>

<summary>Step 2: Download package</summary>

Login to the Blue Storm customer portal ([https://support.bluestorm.io/](https://support.bluestorm.io)), browse to 'Releases', and download the latest release. AppControl is delivered as a Mendix MDA package file.

</details>

<details>

<summary>Step 3: Deploy package</summary>

Depending on your hosting platform, upload the AppControl MDA package to your Mendix server. Afterwards, perform the steps below:

1. Configure the following constants:

* **Core.EncryptionKey** : Use a random 32 character key, and never change it.
* **Core.MxOM\_APIUser** : API user name provided by Blue Storm.
* **Core.MxOM\_APIPassword** : API password provided by Blue Storm.
* **Core.AuthenticationService** : The authentication service to be used for logging into MxOM. Possible values are:
  * **LOCAL** : Local user accounts only.
  * **MENDIX\_SSO** : Use Mendix SSO for authentication.
  * **SAML** : Use SAML for authentication.
* **Logging.LogHistoryDays** : 60

2. Configure the following custom runtime settings:
   * **com.mendix.core.ProcessedTasksCleanupAge** : 86400000
   * **com.mendix.webui.StateSizeWarningThreshold** : 10000
3. Enable all scheduled events.
4. Start the server and login using 'MxOMAdmin'.
5. If you configured AppControl to use SSO for authenticating users, configure SSO from the Administration > Accounts page.
6. Create a new administrator user and give this user the ‘PlatformAdministrator’ role. Login as the new user.

</details>