View source for IOT-DIN-IMX8PLUS: Debian Linux: Installation

== Overview ==
This article provides instructions needed to install the Debian Linux live image onto the Compulab IOT-DIN-IMX8PLUS internal storage.
The recommended installation procedure is using a host PC with a Debian-based operating system.

== Preparing Installation Media ==
Prepare [[IOT-DIN-IMX8PLUS: Debian Linux: Preparing Live Media|Debian Linux Live Media]]

== Installing Debian images onto the internal storage ==
* Insert the USB flash drive into the [[IOT-DIN-IMX8PLUS: Getting Started#Front_panel|USB3.0 port]] located on the front panel
* Power on the device
* Press a key to prevent a possible autoboot and get into the U-Boot command prompt.
* Run a command below:
:<pre>run bsp_bootcmd</pre>
{{Note|''U-Boot 2021.04-compulab-1.5'' version or later runs ''bsp_bootcmd'' by default}}
* Wait for the Linux login prompt
* [[IOT-DIN-IMX8PLUS: Debian_Linux: How-To_Guide#Connection_and_Login|Login]] as '''compulab''' user
* Invoke '''cl-deploy''' utility
:<pre>compulab@compulab-imx8mp:~$ sudo cl-deploy</pre> 
* Select '''/dev/mmcblk2''' as a destination device
<pre>
Select a destination device
─────────────────────────────────────────────────────────────────────────────────────────

       ┌─────────────────────────────────────────────────────────────────────┐
       │  Available Devices:                                                 │
       │ ┌─────────────────────────────────────────────────────────────────┐ │
       │ │                                                                 │ │
       │ │                      (*) /dev/mmcblk2                           │ │
       │ │                                                                 │ │
       │ │                                                                 │ │
       │ │                                                                 │ │
       │ └─────────────────────────────────────────────────────────────────┘ │
       │                     <  OK  >        <Cancel>                        │
       └─────────────────────────────────────────────────────────────────────┘
</pre>
* The following warning message will show up.
<pre>
Start Deployment
─────────────────────────────────────────────────────────────────────────────────────────

       ┌──────────────────────────── WARNING ────────────────────────────────┐
       │ Src: /dev/sda -> Dst: /dev/mmcblk2                                  │
       │                                                                     │
       │ All data on /dev/mmcblk2 will be destroyed                          │
       │                                                                     │
       │                                                                     │
       │                                                                     │
       │─────────────────────────────────────────────────────────────────────│
       │                     <  Yes  >      <  No  >                         │
       └─────────────────────────────────────────────────────────────────────┘
</pre>
* Confirm installation onto internal media by choosing '''Yes'''
* Installation will start
* When installation is complete, the following message will show up:
<pre>
Finished with success
─────────────────────────────────────────────────────────────────────────────────────────

       ┌─────────────────────────────────────────────────────────────────────┐
       │ Boot media has been deployed on /dev/mmcblk2                        │
       │                                                                     │
       │ Would you like to reboot the device now?                            │
       │                                                                     │
       │                                                                     │
       │                                                                     │
       │─────────────────────────────────────────────────────────────────────│
       │                     <  Yes  >      <  No  >                         │
       └─────────────────────────────────────────────────────────────────────┘
</pre>

* Press '''No''' if you want to proceed to [[IOT-DIN-IMX8PLUS: U-Boot: Installation#Running_U-Boot_Firmware_installation| U-Boot installation]]
* Alternatively press '''Yes''' to reboot the device, unplug installation media


[[Category:Linux]]
[[Category:Debian]]
[[Category:IOT-DIN-IMX8PLUS]]