Difference between revisions of "Build Manjaro ISOs with buildiso"

no edit summary
imported>Excalibur1234
imported>Excalibur1234
Line 4: Line 4:
This is a detailed tutorial aimed at beginners how to build Manjaro ISOs.  
This is a detailed tutorial aimed at beginners how to build Manjaro ISOs.  


Manjaro Openbox edition is used as example throughout this tutorial, but there are many more pre-made Manjaro ISO profiles available: cinnamon, enlightenment, gnome, kde, kde5, lxde, lxqt, lxqt-openrc, mate, net, netbook, net-openrc, openbox, openbox-legacy, pekwm-openrc, xfce, xfce-minimal, and xfce-openbox-openrc.
Manjaro Openbox edition is used as example throughout this tutorial, but there are many more pre-made Manjaro ISO profiles available: cinnamon, enlightenment, gnome, i3, kde, kde5, lxde, lxqt, lxqt-openrc, mate, net, net-minimal, netbook, net-openrc, openbox, openbox-legacy, pantheon, pekwm-openrc, xfce, xfce-minimal, and xfce-openbox-openrc.




Line 11: Line 11:
''manjaro-tools-iso-profiles'' is needed for pre-built Manjaro ISO profiles.  
''manjaro-tools-iso-profiles'' is needed for pre-built Manjaro ISO profiles.  


''buildiso'' is needed to build an image/ISO from these profiles. Before March 2015, it used to be part of the ''manjaroiso'' package, but now it is integrated into ''manjaro-tools''.
''buildiso'' is needed to build an image/ISO from these profiles. Before March 2015, it used to be part of the ''manjaroiso'' package, but now it is integrated into ''manjaro-tools-iso''.


Please make sure you always use the absolute latest ''manjaro-tools'' and ''manjaro-tools-iso-profiles'' packages available in order to minimize the chance of random or unexplained bugs.  
Please make sure you always use the absolute latest ''manjaro-tools-iso'' and ''manjaro-tools-iso-profiles'' packages available in order to minimize the chance of random or unexplained bugs.  




==Install manjaro-tools==
==Install manjaro-tools-iso==


''buildiso'' has often bugs introduced my new upstream package changes, therefore it is recommended to install the absolute latest version with the most recent bug fixes. A relatively easy way is to install ''manjaro-tools'' from the unstable repositories of Manjaro.  
''buildiso'' has often bugs introduced my new upstream package changes, therefore it is recommended to install the absolute latest version with the most recent bug fixes. A relatively easy way is to install ''manjaro-tools-iso'' from the unstable repositories of Manjaro.  
Alternatively, you can download and build ''manjaro-tools'' from [https://github.com/manjaro/manjaro-tools GitHub] directly.
Alternatively, you can download and build the complete ''manjaro-tools'' from [https://github.com/manjaro/manjaro-tools GitHub] directly.




If you are using the [https://wiki.manjaro.org/index.php?title=Access_the_Unstable_Repositories unstable repositories] already:
If you are using the [https://wiki.manjaro.org/index.php?title=Access_the_Unstable_Repositories unstable repositories] already:


  sudo pacman -S manjaro-tools
  sudo pacman -S manjaro-tools-iso






If you do '''not''' use the unstable repositories, you need to install ''manjaro-tools'' from the unstable repositories manually:  
If you do '''not''' use the unstable repositories, you need to install ''manjaro-tools-base'' and ''manjaro-tools-iso'' from the unstable repositories manually:  


Please keep in mind that you need to update/re-install this package every time a new version gets released.
Please keep in mind that you need to update/re-install these packages every time a new version gets released.


Go to this Manjaro mirror in your web browser:  
Go to this Manjaro mirror in your web browser:  
  http://mirror.netzspielplatz.de/manjaro/packages/unstable/community/
  http://mirror.netzspielplatz.de/manjaro/packages/unstable/extra/
Choose your architecture and search for the ''manjaro-tools'' package and remember its complete name (especially the version number).  
Choose your architecture and search for the ''manjaro-tools-base'' and ''manjaro-tools-iso'' packages and remember their complete names (especially the version number).  


Then, use your architecture and the name to install ''manjaro-tools'' directly, e.g. with this command:
Then, use your architecture and the name to install ''manjaro-tools-base'' and ''manjaro-tools-iso'' directly, e.g. with these commands:


  sudo pacman -U http://mirror.netzspielplatz.de/manjaro/packages/unstable/community/x86_64/manjaro-tools-0.9.6.2-1-any.pkg.tar.xz
  sudo pacman -U http://mirror.netzspielplatz.de/manjaro/packages/unstable/extra/x86_64/manjaro-tools-base-0.9.8-3-any.pkg.tar.xz
 
sudo pacman -U http://mirror.netzspielplatz.de/manjaro/packages/unstable/extra/x86_64/manjaro-tools-iso-0.9.8-3-any.pkg.tar.xz




Line 231: Line 233:
=manjaro-tools.conf=
=manjaro-tools.conf=


<code>manjaro-tools.conf</code> is the central configuration file for ''manjaro-tools''/''buildiso''. Only edit the general and the "buildiso" part to not exceed the scope of this tutorial. If you are not sure what and how to edit it, do '''not''' edit it. You can always use arguments with the <code>buildiso</code> command later.  
<code>manjaro-tools.conf</code> is the central configuration file for all tools part of ''manjaro-tools''. Only edit the general and the "buildiso" part to not exceed the scope of this tutorial. If you are not sure what and how to edit it, do '''not''' edit it. You can always use arguments with the <code>buildiso</code> command later.  


By default, the systemwide config file is installed in
By default, the systemwide config file is installed in