> For the complete documentation index, see [llms.txt](https://docs.auterion.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.auterion.com/~/changes/TDRfjBXXgHmxK48cWqay/vehicle-operation/auterion-mission-control/installation.md).

# Installation

How to install Auterion Mission Control

## Download the latest version

You can download AMC from [Auterion Suite](https://suite.auterion.com/downloads).

Installers of Auterion Mission Control are provided for *Android,* *Ubuntu Linux, Windows and MacOS*.\
These can be installed locally on the different host operating systems using the system's usual methods.

## Supported OS Versions

The following minimum or later OS versions are supported.

| **OS**       | **Minimum Version** |
| ------------ | ------------------- |
| Android      | Android 5.1         |
| Ubuntu Linux | Ubuntu Linux 18.04  |
| Windows      | Windows 10          |
| MacOS        | MacOS 13.5          |

## Android

The Android installer is provided as an Android Package Kit/APK file (e.g.: file extension **.apk**).

{% hint style="info" %}
*Mission Control* is intended to run on tablet devices. While you may be able to install it on an Android phone, the UI may be not render all elements correctly.
{% endhint %}

To install and run *AMC*:

1. Enable APK installation on your device.\
   The setting to use depends on the version of Android - it might be

   * Settings > Security > Device Administration > Enable Unknown Sources
   * Settings > Security and Lock Screen > Device Administration > Enable Unknown Sources
   * Settings > Apps and Notifications > Install Unknown Apps
   * Settings > Apps and Notifications > Install Other Apps

   If none of those options are available check the documentation for your device.
2. Install the APK file using the standard installer (just acknowledge all prompts)
3. Run *AMC* from the device launcher.
4. The first time it is run, acknowledge the prompts to grant location and media permissions.

   ![LocationPermission](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-e73059d4feb6c30ea64ad4fe1fa88baf4f5adb88%2FAndroidAgsLocationPermission.png?alt=media)

   ![MediaPermission](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-3f7f6abac03f271991e1f524027657707d8cb4b2%2FAndroidAgsMediaPermission.png?alt=media)

## Ubuntu Linux

The Ubuntu installer is provided as a zip file that contains an **Linux Script** file (e.g. file extension: **.AppImage.zip**).

Before installing *AMC* for the first time:

1. Remove the Ubuntu serial modem manager by entering the following command in the Ubuntu terminal:

   ```
   sudo usermod -a -G dialout $USER
   sudo apt-get remove modemmanager -y
   ```
2. Install *GStreamer* (for video streaming) by entering the following command:

   ```
   sudo apt install libgstreamer-plugins-base1.0-0 libgstreamer-plugins-good1.0-0 libgstreamer-plugins-bad1.0-0 gstreamer1.0-libav gstreamer1.0-rtsp gstreamer1.0-vaapi libxcb-xinerama0 libxcb-image0 libxcb-keysyms1 libxcb-render-util0
   ```
3. Logout and login again to reload the user permissions

### **Required Packages:**

In order to use the installer, Ubuntu must have the following packages installed:

* zenity
* nautilus

Both packages are are included in the standard Ubuntu distribution. Verify the packages have not been removed from your distribution/setup.

### Required Configuration

Configure the Gnome environment. The configuration described below is the default on Ubuntu. Follow these steps to verify configuration.

1. In the file manager (Files in Ubuntu), select Preferences, then the Behavior tab.
2. Under the 'Executable Text Files' section, select the 'Run them' option.
3. Close Preferences.

![](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-77fc1776ff5594fbcdca096453d52e8cf2d87de5%2Fimage%20\(150\).png?alt=media)

![](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-cdfc6016570a648df498c6e8dcee4f1cff52a125%2Fimage%20\(231\).png?alt=media)

### AMC Installer

The AMC installer facilitates setting up AMC on remote control units with and without a keyboard. A user can install AMC only by using click (tap) and double-click (double-tap). The installer is designed to work with Ubuntu 18.04 LTS and the Gnome desktop. Please perform the following steps from Nautilus/Files and not directly from the Desktop, because they might not work.

1. Download `Auterion Mission Control vX.XX.X for Linux`. This will download a ZIP file.
2. Extract the ZIP content
   1. Double click on the .zip file to view the archive contents
   2. Select the script file and click 'Extract'
   3. Confirm the operation and the output directory
3. The installation script with the .sh file extension is self-contained. The script already has executable permissions, ie. the execute flag '+x' is already set.
4. Double-click on the script to run. A progress bar will display installation status.
5. After a successful installation, the folder where AMC is installed will be opened.
6. An AMC Desktop icon is created (see Note 1 below). AMC will have a default, blank icon because AMC is not yet trusted application. Follow these steps to enable the AMC icon. These are required for the first AMC installation only.
   1. Double click on the icon
   2. Mark AMC as trusted application
   3. Icon changes with the AMC logo

The AMC installer also integrates with the Ubuntu Search Bar.

**NOTE:** v.X.XX.X is the version number (ie. v1.12.0)