Build Manjaro ISOs with buildiso

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.

Prerequisites

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.

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.

Install manjaro-tools

use the following command, if you are using the [url=https://wiki.manjaro.org/index.php?title=Access_the_Unstable_Repositories]unstable repositories[/url]: [code] sudo pacman -S manjaro-tools [/code]

if you do [b]not[/b] use the unstable repositories, you need to install manjaro-tools from the unstable repositories manually. please keep in mind that you need to update this package manually, too: go here: http://mirror.netzspielplatz.de/manjaro/packages/unstable/community/ , choose your architecture and search for the "manjaro-tools" package and remember its complete name. then, use your architecture and the name to install manjaro-tools directly, e.g. with this command: [code] sudo pacman -U http://mirror.netzspielplatz.de/manjaro/packages/unstable/community/x86_64/manjaro-tools-0.9.6.2-1-any.pkg.tar.xz [/code]

[b]2. [/b]next, clone manjaro-tools profiles from github (this requires git: sudo pacman -S git): [code] git clone https://github.com/manjaro/manjaro-tools-iso-profiles.git [/code]

whenever you want to update the profile directory with the latest files, execute these commands: [code] cd manjaro-tools-iso-profiles [/code] [code] git pull origin master [/code]

[b]3. [/b]edit the config file directly (as root): [code]/etc/manjaro-tools/manjaro-tools.conf[/code] or copy it here (and edit as normal user): [code]~/.config/manjaro-tools.conf[/code] (only edit the general part and the "buildiso" part. if you are not sure what/how to edit, do NOT edit anything)

alternatively, there is a light version of this config file in your profile folder called [code]profile.conf[/code] e.g.: ~/manjaro-tools-iso-profiles/openbox/profile.conf

[b]4.[/b] if you want to know how the folder structure in manjaro-tools-iso-profiles/openbox works, read here: - the readme.md file here (only read section 1 and 3): https://github.com/manjaro/manjaro-tools - read this wiki (not the part about installing manjaroiso): https://wiki.manjaro.org/index.php?title=Manjaroiso#Understanding_ManjaroISO_Profiles

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: - these files are not present anymore in manjaro-tools: isolinux, isomounts, syslinux - the "options.conf" file has completely changed and its new equivalent is called "profile.conf" - the "pacman-i686.conf" and "pacman-x86_64.conf" files have been renamed to "pacman-default.conf" and "pacman-multilib.conf"

if you want to add AUR packages to your iso, you need to create a local repository and add it to corresponding pacman.conf file. read here how to do it for manjaroiso (keep the changes between manjaroiso and manajro-tools in mind): https://wiki.manjaro.org/index.php?title=How_to_install_AUR_packages_in_ManjaroISO

[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: [code] sudo buildiso -p openbox -q [/code]

then, start to build the iso for real: [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

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

[b]7.[/b] when you have questions about buildiso, please search for answers in these forum subsections: https://forum.manjaro.org/index.php?board=52.0 https://forum.manjaro.org/index.php?board=27.0 here are some more tutorials of manjaro-tools: https://forum.manjaro.org/index.php?topic=20167.0 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: 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: [code] paccache -ruk0 [/code]

you can also manually look into [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.