[{"data":1,"prerenderedAt":448},["ShallowReactive",2],{"\u002Fdocs\u002Fdevelopers\u002Fbuilding-the-iso":3},{"id":4,"title":5,"body":6,"description":440,"extension":441,"meta":442,"navigation":443,"path":444,"seo":445,"stem":446,"__hash__":447},"docs\u002Fdocs\u002Fdevelopers\u002Fbuilding-the-iso.md","Building the ISO",{"type":7,"value":8,"toc":433},"minimark",[9,13,32,37,61,110,122,126,197,209,234,237,254,258,265,305,309,384,391,395,422,429],[10,11,5],"h1",{"id":12},"building-the-iso",[14,15,16,17,25,26,31],"p",{},"The LeiOS installation image is built with Debian's\n",[18,19,24],"a",{"href":20,"rel":21,"target":23},"https:\u002F\u002Flive-team.pages.debian.net\u002Flive-manual\u002F",[22],"nofollow","_blank","live-build",". Its configuration\nlives in the ",[18,27,30],{"href":28,"rel":29,"target":23},"https:\u002F\u002Fgit.leicraftmc.de\u002FLeiOS\u002Flive-images",[22],"live-images","\nrepository.",[33,34,36],"h2",{"id":35},"requirements","Requirements",[38,39,40,44,51,58],"ul",{},[41,42,43],"li",{},"A Debian or Ubuntu build host. Debian stable or testing is recommended.",[41,45,46,50],{},[47,48,49],"code",{},"sudo"," access.",[41,52,53,54,57],{},"Several gigabytes of free space in ",[47,55,56],{},"\u002Ftmp"," and in the working directory.",[41,59,60],{},"These packages:",[62,63,68],"pre",{"className":64,"code":65,"language":66,"meta":67,"style":67},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","sudo apt-get update\nsudo apt-get install live-build debootstrap squashfs-tools xorriso syslinux-common\n","bash","",[47,69,70,85],{"__ignoreMap":67},[71,72,75,78,82],"span",{"class":73,"line":74},"line",1,[71,76,49],{"class":77},"sBMFI",[71,79,81],{"class":80},"sfazB"," apt-get",[71,83,84],{"class":80}," update\n",[71,86,88,90,92,95,98,101,104,107],{"class":73,"line":87},2,[71,89,49],{"class":77},[71,91,81],{"class":80},[71,93,94],{"class":80}," install",[71,96,97],{"class":80}," live-build",[71,99,100],{"class":80}," debootstrap",[71,102,103],{"class":80}," squashfs-tools",[71,105,106],{"class":80}," xorriso",[71,108,109],{"class":80}," syslinux-common\n",[14,111,112,113,115,116,121],{},"The ",[47,114,41],{}," helper script also needs ",[18,117,120],{"href":118,"rel":119,"target":23},"https:\u002F\u002Fbun.sh",[22],"Bun",". It offers to install Bun\nif it is missing.",[33,123,125],{"id":124},"build","Build",[62,127,129],{"className":64,"code":128,"language":66,"meta":67,"style":67},"git clone https:\u002F\u002Fgit.leicraftmc.de\u002FLeiOS\u002Flive-images.git\ncd live-images\n\n# Configure the build (first time, and after every configuration change)\nsudo lb config\n\n# Build the image\nsudo lb build\n",[47,130,131,142,151,158,165,176,181,187],{"__ignoreMap":67},[71,132,133,136,139],{"class":73,"line":74},[71,134,135],{"class":77},"git",[71,137,138],{"class":80}," clone",[71,140,141],{"class":80}," https:\u002F\u002Fgit.leicraftmc.de\u002FLeiOS\u002Flive-images.git\n",[71,143,144,148],{"class":73,"line":87},[71,145,147],{"class":146},"s2Zo4","cd",[71,149,150],{"class":80}," live-images\n",[71,152,154],{"class":73,"line":153},3,[71,155,157],{"emptyLinePlaceholder":156},true,"\n",[71,159,161],{"class":73,"line":160},4,[71,162,164],{"class":163},"sHwdD","# Configure the build (first time, and after every configuration change)\n",[71,166,168,170,173],{"class":73,"line":167},5,[71,169,49],{"class":77},[71,171,172],{"class":80}," lb",[71,174,175],{"class":80}," config\n",[71,177,179],{"class":73,"line":178},6,[71,180,157],{"emptyLinePlaceholder":156},[71,182,184],{"class":73,"line":183},7,[71,185,186],{"class":163},"# Build the image\n",[71,188,190,192,194],{"class":73,"line":189},8,[71,191,49],{"class":77},[71,193,172],{"class":80},[71,195,196],{"class":80}," build\n",[14,198,199,200,203,204,208],{},"The image is written to the repository root as ",[47,201,202],{},"leios-\u003Cversion>-amd64.hybrid.iso",". Write it to a USB\ndrive as described in ",[18,205,207],{"href":206},"\u002Fdocs\u002Fgetting-started\u002Finstallation#write-it-to-a-usb-drive","Installation",".",[14,210,112,211,213,214,217,218,221,222,225,226,229,230,233],{},[47,212,41],{}," helper runs the full cycle in one go: ",[47,215,216],{},".\u002Fli build"," runs ",[47,219,220],{},"lb clean --all",", ",[47,223,224],{},"lb config"," and\n",[47,227,228],{},"lb build",". Like the ",[47,231,232],{},"lb"," commands, it needs root privileges.",[14,235,236],{},"For a clean, reproducible build, drop the package cache first:",[62,238,240],{"className":64,"code":239,"language":66,"meta":67,"style":67},"sudo lb clean --purge\n",[47,241,242],{"__ignoreMap":67},[71,243,244,246,248,251],{"class":73,"line":74},[71,245,49],{"class":77},[71,247,172],{"class":80},[71,249,250],{"class":80}," clean",[71,252,253],{"class":80}," --purge\n",[33,255,257],{"id":256},"what-the-build-contains","What the build contains",[14,259,260,261,264],{},"The live-build configuration (",[47,262,263],{},"auto\u002Fconfig",") builds:",[38,266,267,274,291],{},[41,268,269,270,273],{},"Debian 13 \"trixie\" for ",[47,271,272],{},"amd64",", with the security, updates and backports sources,",[41,275,276,277,221,280,221,283,286,287,290],{},"the ",[47,278,279],{},"main",[47,281,282],{},"contrib",[47,284,285],{},"non-free"," and ",[47,288,289],{},"non-free-firmware"," archive areas, including firmware,",[41,292,293,294,297,298,301,302,208],{},"a hybrid ISO that boots on BIOS (",[47,295,296],{},"grub-pc",") and UEFI (",[47,299,300],{},"grub-efi",") machines, with ",[47,303,304],{},"memtest86+",[33,306,308],{"id":307},"customizing","Customizing",[310,311,312,325],"table",{},[313,314,315],"thead",{},[316,317,318,322],"tr",{},[319,320,321],"th",{},"Path",[319,323,324],{},"Purpose",[326,327,328,339,353,363,373],"tbody",{},[316,329,330,336],{},[331,332,333],"td",{},[47,334,335],{},"config\u002Fpackage-lists\u002F*.list.chroot",[331,337,338],{},"Packages installed into the image.",[316,340,341,346],{},[331,342,343],{},[47,344,345],{},"config\u002Fincludes.chroot\u002F",[331,347,348,349,352],{},"Files copied into the image as is, for example ",[47,350,351],{},"etc\u002Fos-release",", the APT sources and the Calamares configuration.",[316,354,355,360],{},[331,356,357],{},[47,358,359],{},"config\u002Fhooks\u002F*.hook.chroot",[331,361,362],{},"Scripts that run inside the image during the build, for example installing the LeiOS signing key.",[316,364,365,370],{},[331,366,367],{},[47,368,369],{},"config\u002Fbootloaders\u002F",[331,371,372],{},"Boot menu configuration and theme.",[316,374,375,379],{},[331,376,377],{},[47,378,263],{},[331,380,112,381,383],{},[47,382,224],{}," options: distribution, architectures, archive areas, image name.",[14,385,386,387,390],{},"Run ",[47,388,389],{},"sudo lb config"," again after changing the configuration.",[33,392,394],{"id":393},"troubleshooting","Troubleshooting",[38,396,397,406,416],{},[41,398,399,403,404,57],{},[400,401,402],"strong",{},"The build runs out of space."," Free up space in ",[47,405,56],{},[41,407,408,411,412,415],{},[400,409,410],{},"A build fails unexpectedly."," Clear stale artifacts with ",[47,413,414],{},"sudo lb clean --purge"," and rebuild.",[41,417,418,421],{},[400,419,420],{},"You need details."," Check the live-build log in the build tree.",[14,423,424,425,208],{},"For everything else, see the ",[18,426,428],{"href":20,"rel":427,"target":23},[22],"Debian Live manual",[430,431,432],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}",{"title":67,"searchDepth":87,"depth":87,"links":434},[435,436,437,438,439],{"id":35,"depth":87,"text":36},{"id":124,"depth":87,"text":125},{"id":256,"depth":87,"text":257},{"id":307,"depth":87,"text":308},{"id":393,"depth":87,"text":394},"Build the LeiOS live image yourself with Debian live-build.","md",{},{"title":5},"\u002Fdocs\u002Fdevelopers\u002Fbuilding-the-iso",{"title":5,"description":440},"docs\u002Fdevelopers\u002Fbuilding-the-iso","Z3g8N-j6FgOzU1qPl6BM0hYHLUJfHMHEjLDmlLWhu0I",1792353301762]