How to build a Linux image

this page describes how to build an os image locally on your computer this is useful for testing your changes in the os components on flipper one or any of the supported boards docid 5zr6i3iehbjbwmr3n9bd before submitting pull request to the repository when building an image locally, the same workflow is used as on the build server this workflow is described in the build system docid\ isvwirz7zz0je7grahigs page step 1 install required tools the operating system image is built inside a docker container, ensuring cross platform compatibility of the build process before starting the image build, install the required components to ensure that the container runs properly macos install docker desktop https //www docker com/ install git https //git scm com/install/mac ‎ linux (debian) install the required packages sudo apt install y docker io docker cli git qemu user binfmt add the current user to the docker group and apply it in the current session sudo usermod ag docker $user && newgrp docker ‎ windows 10/11 open a terminal and start the installation of wsl 2 (windows subsystem for linux v2) with debian distribution wsl install d debian restart your computer after rebooting, the installation of the debian distribution will continue automatically you’ll be prompted to create a unix username and password during installation install the required packages sudo apt install y docker io docker cli git qemu user binfmt add the current user to the docker group and apply it in the current session sudo usermod ag docker $user && newgrp docker close the terminal step 2 build an os image building an os image is a long running process that takes from several tens of minutes to over an hour to build an os image open the terminal in the folder where you plan to save image build system on linux/macos skip this step on windows enter the debian terminal wsl d debian go to the debian user’s home directory cd ˜ clone the os image build scripts repository git clone https //github com/flipperdevices/flipperone linux build scripts && cd flipperone linux build scripts build the docker image docker build t flipperone linux build scripts run the container docker run privileged rm v $(pwd)/out /artifacts flipperone linux build scripts wait for the build to complete the full disk os images are stored in linux and macos flipperone linux build scripts/out/images windows 10/11 linux/debian/home/\[wsl user]/flipperone linux build scripts/out/images you can now install the image to your board how to install an image md