# Installation guide

## Supported platforms

- **i.MX8**

    - CCPilot V510
    - CCPilot V700
    - CCPilot V705
    - CCPilot V710
    - CCPilot V1000
    - CCPilot V1200
    - CCPilot V1090
    - CCPilot V1290

- **Core i7**

    - CCPilot X1200

## Prerequisites

### v1.0.0

- CCLinux 4.+
- Qt-6.8.+

## Installing Window Manager on i.MX8 & Core i7

Window Manager can be installed on the target in two different ways.

### RAUC bundle

For production use the Window Manager should be installed on the target using a RAUC bundle.  
Reference the `CC Linux - Using RAUC` documentation on the support web site for more information about how to generate a RAUC bundle.

### Installing Window Manger manually for development/testing

During development or testing of the Window Manager it can be installed on the target by unlocking `appfs` and manually installing it by unpacking the tarball, tar.gz, under `appfs`.

#### Unlock /appfs for development/testing

1. Open an ssh session to the target:
    <code>ssh ccs\<ip-address></code>
2. Change write permissions of /appfs:
    <code>sudo mount -o remount,rw /appfs</code>
3. Check which version partition /appfs is mounted to:
    <code>rauc status</code>
4. Unmount /appfs:
    <code>sudo umount /appfs</code>
5. Format the partition:
    <code>sudo mkfs.ext4 /dev/\<partition></code>
6. Remount /appfs:
    <code>sudo mount /dev/\<partition> /appfs</code>

#### Unpacking tarball

1. Download the tarball, window-manager-ccl4x_1.0.0_\<TARGET>.tar.gz, from the support site under:
    `Software & Solution -> Window Manager -> Downloads -> Device module -> <TARGET>`
2. Transfer the tar.gz package to device:
    <code>scp window-manager-ccl4x_1.0.0_\<TARGET>.tar.gz ccs@\<ip-address>:/tmp</code>
3. Open an ssh session to the target:
    <code>ssh ccs@\<ip-address></code>
4. Change directory to `/tmp`:
    <code>cd /tmp</code>
3. Run the following code to unpack it:
    <code>sudo tar xzf window-manager-ccl4x_1.0.0_\<TARGET>.tar.gz -C /appfs</code>
4. Window Manager will not automatically start at boot. See [Getting Started Guide](#getting-started-guide).

## Getting Started Guide

Please refer to our **Knowledge Base** [Window Manager article](https://crosscontrol.com/support/knowledge-base/solution-recipes/window-manager-example/) regarding Window Manager for a guide on how to deploy multiple Qt applications in Window Manager module on CCpilot target displays.