=================================================
Building DreamOS Images via Podman
Container on Modern Linux Distributions
ubuntu/debian
==================================================
Podman Container :
An open-source tool for managing containers without the need for a background service (daemon), considered a safer and lighter-weight alternative to Docker. It allows us to:
- Build Container Images
- Run containers with complete isolation
- Manage networking and Volumes
- Run without root privileges (rootless mode) → Higher security.
In the Script :
Podman is used for:
- Isolating the build environment: (OpenEmbedded + BitBake + Git) within a dedicated container.
- Compatibility with modern distributions: (e.g., Ubuntu 24.04/25.10) without conflict — because the base environment (Ubuntu 16.04/18.04) is internally emulated/simulated via the image.
- Repeatability and portability: Build the image once → run it on any system that supports Podman.
- Secure integration with SSH: By binding the SSH_AUTH_SOCK inside the container — without manually copying keys.
Compatible Linux Distributions :
The script is designed to run on Linux distributions based on (Ubuntu/Debian) such as:
ubuntu - zorin os - deepin - linux mint - AnduinOS - Pop!_OS - MX linux
Lubuntu - Elementary OS - Ubuntu Budgie - Kali Linux - Ubuntu Unity.....etc
Workflow / Steps :
- A GitHub account is available / required
- Download the opendreambox.sh script from the attachments
- Execute the script using the following commands in the Terminal:
============================================================================================================================================================
=============================================================================================================================================================
Here, upon clicking OK, the key is copied to the clipboard and the GitHub website page opens directly
=============================================================================================================================================================
=============================================================================================================================================================
• The build folder is located at the path: home/opendreambox-krogoth or home/opendreambox-pyro
• After completion, you will find the image at the path: home/opendreambox-xxxx/build/dmxxx/tmp-glibc/deploy/images/dmxxx
• To directly access the device image build (after building the container image) via the terminal, use : krogoth-build or pyro-build
• To access the build folder via the terminal, use: pyro-shell or ( the equivalent for krogoth-shell)
