# Installation guide

## Supported platforms

* **i.MX 8**
  * CCPilot V700
  * CCPilot V1000
  * CCPilot V1200

* **CORE i7**
  * CCPilot X1200

## Prerequisites
### v1.3.+
* Qt-6.4.1 
### v1.4.+
* Qt-6.5.3
### v1.2.0
* Qt-5.15.2


## Installing CC Web browser

### i.MX 8
#### QT6

1. Download `ccwebbrowser_1.4.0_<target-display>.ipk` from the support site under:  
`Web browser module -> Downloads -> Device Download -> CC Linux 3.0 -> <target-display>`
2. Transfer the ipk package to device
3. Run <code>opkg install 'package-name'</code>
4. Edit the <code>/opt/ccwebbrowser/config/browser.conf</code> file to add your url.
5. By default the web browser is running with Qt platform switch <code>-platform eglfs</code>. If the browser should run as a wayland client, edit the ccwebbrowser.service systemd script and change the platform to <code>-platform wayland</code> instead.
6. Now the web browser should automatically start at boot

#### QT5

1. Download `ccwebbrowser_1.2.0_<target-display>.ipk` from the support site under:  
`Web browser module -> Downloads -> Device Download -> CC Linux 2.0 -> <target-display>`
2. Transfer the ipk package to device
3. Run <code>opkg install 'package-name'</code>
4. Edit the <code>/opt/ccwebbrowser/config/browser.conf</code> file to add your url.
5. By default the web browser is running with Qt platform switch <code>-platform eglfs</code>. If the browser should run as a wayland client, edit the ccwebbrowser.service systemd script and change the platform to <code>-platform wayland</code> instead.
6. Now the web browser should automatically start at boot

### CORE i7
#### QT6
1. Download `ccwebbrowser_1.4.0_<target-display>.ipk` from the support site under:  
`Web browser module -> Downloads -> Device Download -> CC Linux 3.0 -> <target-display>`
2. Transfer the ipk package to device
3. Run <code>opkg install 'package-name'</code>
4. Edit the <code>/opt/ccwebbrowser/config/browser.conf</code> file to add your url.
5. By default the web browser is running with Qt platform switch <code>-platform eglfs</code>. If the browser should run as a wayland client, edit the ccwebbrowser.service systemd script and change the platform to <code>-platform wayland</code> instead.
6. Now the web browser should automatically start at boot

## Troubleshooting

Please refer to our [Knowledge
Base](https://support.crosscontrol.com/knowledge-base) for further information
and troubleshooting guides.