Skip to content

Commit 2032d7d

Browse files
committed
Skopeo concept & fundamental documentation update
1 parent e6d1697 commit 2032d7d

File tree

2 files changed

+72
-39
lines changed

2 files changed

+72
-39
lines changed

content/hardware/04.pro/boards/portenta-x8/tutorials/01.user-manual/content.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -858,6 +858,30 @@ This way, your Docker image will be built and tagged with the name `x8-custom-de
858858

859859
It is time for you to deploy the newly created Docker image. To do so, save it somewhere and deploy it on your Portenta X8.
860860

861+
### Managing Early Start Services When Building Custom Containers
862+
863+
The Portenta X8 firmware includes **`compose-apps-early-start.service`**, which starts certain Docker Compose applications early during the boot process. This feature helps pre-configured services run smoothly but may sometimes interfere with custom containers you pull or build.
864+
865+
For example, system tools like [**Skopeo**](https://www.redhat.com/en/topics/containers/what-is-skopeo) may automatically remove containers without warning. This can happen to containers pulled from external sources or locally built on the device. If you notice that your custom containers are being removed unexpectedly, you can solve this by managing the system services with a few command lines.
866+
867+
To prevent automatic container removal and ensure your custom containers stay intact, the early start services can be stopped and disabled by running the following commands in the ADB shell:
868+
869+
```bash
870+
systemctl stop compose-apps-early-start.service
871+
systemctl stop compose-apps-early-start-recovery.service
872+
systemctl disable compose-apps-early-start.service
873+
systemctl disable compose-apps-early-start-recovery.service
874+
```
875+
876+
Alternatively, you can use this single line of command:
877+
878+
```bash
879+
systemctl stop compose-apps-early-start.service && systemctl stop compose-apps-early-start-recovery.service && systemctl disable compose-apps-early-start.service && systemctl disable compose-apps-early-start-recovery.service
880+
```
881+
882+
Stopping and disabling these services will prevent the early start of compose applications, ensuring your custom containers are not removed automatically. Additionally, make sure to check for the [*latest firmware image*](https://downloads.arduino.cc/portentax8image/image-latest.tar.gz) to maintain compatibility and optimal performance of the Portenta X8 with custom container developments.
883+
884+
861885
### Deploy Your Container With Docker Hub
862886

863887
If you have a [Docker Hub account](https://hub.docker.com/), you can freely upload your Docker image to your registry (e.g., `yourhubusername`):

0 commit comments

Comments
 (0)