Manjaro

Difference between revisions of "Build Manjaro ISOs with buildiso"

Build Manjaro ISOs with buildiso (view source)

Revision as of 16:07, 2 May 2015

376 bytes added ,  9 years ago
no edit summary
imported>Excalibur1234
imported>Excalibur1234
Line 53: Line 53:


  git pull origin master
  git pull origin master
=ISO profile=
You can adjust everything you want to change in your ISO (add packages or other files, adjust settings, etc.) in your profile folder located here:
manjaro-tools-iso-profiles/openbox/
If you want to know how the folder structure in your profile folder works, read:
* (only section 1 and 3) of the <code>README.md</code> file [https://github.com/manjaro/manjaro-tools here]
* [https://wiki.manjaro.org/index.php?title=Manjaroiso#Understanding_ManjaroISO_Profiles this Wiki] (not the part about installing ''manjaroiso'')
* [https://wiki.manjaro.org/index.php?title=Manjaro-tools#Overview this Wiki section]
When reading about ''manjaroiso'' (either in the link given above or in other places), please note the differences between the old ''manjaroiso'' and the new ''manjaro-tools''. The most obvious are in your profile directory <code>manjaro-tools-iso-profiles/openbox</code>:
* these files are not present anymore: <code>isolinux</code>, <code>isomounts</code>, <code>syslinux</code>
* the <code>options.conf</code> file has completely changed and its new equivalent is called <code>profile.conf</code>
* the <code>pacman-i686.conf</code> and <code>pacman-x86_64.conf</code> files have been renamed to <code>pacman-default.conf</code> and <code>pacman-multilib.conf</code>
If you want to add AUR packages to your ISO, you need to create a local repository and add it to the corresponding <code>pacman.conf</code> file. Read here how to do it for ''manjaroiso'' (keep the changes between ''manjaroiso'' and ''manajro-tools'' in mind): [[How to install AUR packages in ManjaroISO]]




Line 74: Line 96:




=ISO profile=
=Build your ISO=
 
Navigate to the <code>manjaro-tools-iso-profiles</code> folder:
 
cd manjaro-tools-iso-profiles
 
 
Query build your ISO. This gives you a nice overview of what is going to happen:
 
sudo buildiso -p openbox -q
 
You can use arguments for more build options. Here a short example:
 
sudo buildiso -p openbox -a i686 -b unstable -q
 
 
Then, start to build your ISO for real (just remove the <code>-q</code> argument):
 
sudo buildiso -p openbox
 
 
If the build process fails with an error, start it again.
 
Attention: The build process needs at least 10min to complete or much longer when you are using HDDs, slow CPUs, or large ISOs.
 
You can find other examples of builds using different arguments for ''buildiso'' [https://wiki.manjaro.org/index.php?title=Manjaro-tools#buildiso here].
 
 
When the build process finishes successfully, the ISO file(s) will appear in this folder:
 
/var/cache/manjaro-tools/iso/
 
 
=Cleaning your hard drive=
 
After a successful or failed build, you can get rid of most data (the "raw" ISO with all downloaded packages) by deleting this folder:
 
sudo rm -r /opt/buildiso/openbox/
 
 
To clean your system of packages not installed on your system, do:
 
paccache -ruk0
 


If you want to know how the folder structure in <code>manjaro-tools-iso-profiles/openbox</code> works, read:
You can also manually look into
* (only section 1 and 3) of the <code>README.md</code> file [https://github.com/manjaro/manjaro-tools here]
* [https://wiki.manjaro.org/index.php?title=Manjaroiso#Understanding_ManjaroISO_Profiles this Wiki] (not the part about installing ''manjaroiso'')
* [https://wiki.manjaro.org/index.php?title=Manjaro-tools#Overview this Wiki section]


When reading about ''manjaroiso'' (either in the link given above or in other places), please note the differences between the old ''manjaroiso'' and the new ''manjaro-tools''. The most obvious are in your profile directory <code>manjaro-tools-iso-profiles/openbox</code>:
/var/cache/manjaro-tools/
* these files are not present anymore: <code>isolinux</code>, <code>isomounts</code>, <code>syslinux</code>
* the <code>options.conf</code> file has completely changed and its new equivalent is called <code>profile.conf</code>
* the <code>pacman-i686.conf</code> and <code>pacman-x86_64.conf</code> files have been renamed to <code>pacman-default.conf</code> and <code>pacman-multilib.conf</code>


and delete folders or files to your liking.


If you want to add AUR packages to your ISO, you need to create a local repository and add it to the corresponding <code>pacman.conf</code> file. Read here how to do it for ''manjaroiso'' (keep the changes between ''manjaroiso'' and ''manajro-tools'' in mind): [[How to install AUR packages in ManjaroISO]]


Please remember that all these packages and files are saved for your convenience. If you clean your system like suggested above, you have to download '''all''' packages and build '''all''' images again the next time you want to build your own Manjaro ISO.


[b]5. [/b]navigate to the manjaro-tools-iso-profiles folder:
[code]
cd manjaro-tools-iso-profiles
[/code]


and query build your iso. this gives you a nice overview of what is going to happen:
=Questions?=
[code]
sudo buildiso -p openbox -q
[/code]


then, start to build the iso for real:
When you have questions about ''buildiso'', please search for answers in these forum subsections:
[code]
sudo buildiso -p openbox
[/code]
if the build process fails with an error, start it again. attention: the build process needs at least 10min to complete or much longer when you are using HDDs, slow CPUs, and large ISOs.
you can find examples of builds here: https://wiki.manjaro.org/index.php?title=Manjaro-tools#buildiso


* [https://forum.manjaro.org/index.php?board=52.0 Support for Manjaro-Tools]
* [https://forum.manjaro.org/index.php?board=27.0 Support for ManjaroISO]


[b]6. [/b]when the build process finishes successfully, the ISO file(s) will appear here:
[code]
/var/cache/manjaro-tools/iso/
[/code]


Here are some more tutorials of ''manjaro-tools'':


[b]7.[/b] when you have questions about buildiso, please search for answers in these forum subsections:
* [https://forum.manjaro.org/index.php?topic=20167.0 How to use Manjaro-Tools]
https://forum.manjaro.org/index.php?board=52.0
* [[Manjaro-tools]]
https://forum.manjaro.org/index.php?board=27.0
* [https://github.com/manjaro/manjaro-tools manjaro-tools on GitHub]
here are some more tutorials of manjaro-tools:
* [https://forum.manjaro.org/index.php?topic=21976.0 buildiso tutorial]
https://forum.manjaro.org/index.php?topic=20167.0
* [https://forum.manjaro.org/index.php?topic=20451.0 How To build manjaro ISOs (for beginners)]
https://forum.manjaro.org/index.php?topic=21976.0
or ask on IRC:
server: irc.freenode.net
channel: #manjaro




[b]8. [/b]cleaning your hard drive:  
Or ask on IRC:  
after a successful or failed build, you can get rid of most data (the "raw" ISO with all downloaded packages) by deleting this folder:
[code]
sudo rm -r /opt/buildiso/openbox/
[/code]


to clean your system of packages not installed on your system, do:
Server: <code>irc.freenode.net</code>
[code]
paccache -ruk0
[/code]


you can also manually look into
Channel: <code>#manjaro</code>
[code]
/var/cache/manjaro-tools/
[/code]
and delete folders or files.


please remember that all these packages and files are saved for your convenience. if you clean your system like suggested above, you have to download ALL packages and build ALL images again the next time you want to build your own manjaro ISO.




[b]9. [/b]when you changed a lot or something important in your manjaro openbox edition, please contact the team. either they give you write access in the manjaro-tools-iso-profiles github or you can fork the manjaro-tools-iso-profiles project and do a pull request. then, your changes will be available for everybody.
[[Category:Contents Page]]
Retrieved from "https://wiki.manjaro.org/index.php/Special:MobileDiff/2879"