8,138
edits
Difference between revisions of "Build Manjaro ISOs with buildiso/en"
Updating to match new version of source page
(Updating to match new version of source page) |
(Updating to match new version of source page) Tags: Mobile web edit Mobile edit |
||
| Line 10: | Line 10: | ||
==Install Manjaro Tools== | ==Install Manjaro Tools== | ||
To get started you need to the following | To get started you need to the following packages | ||
{{UserCmd|command=pamac install manjaro-tools-iso git}} | |||
We will be working with the official XFCE to help you understand what you need to do. | We will be working with the official XFCE to help you understand what you need to do. | ||
| Line 20: | Line 20: | ||
The latest profiles can be found in the Manjaro gitlab. You can download them directly using the command: | The latest profiles can be found in the Manjaro gitlab. You can download them directly using the command: | ||
{{UserCmd|command=git clone <nowiki>https://gitlab.manjaro.org/profiles-and-settings/iso-profiles.git</nowiki> ~/iso-profiles}} | |||
==ISO profile overview== | ==ISO profile overview== | ||
The ISO profile for xfce can now be found at | The ISO profile for xfce can now be found at | ||
~/iso-profiles/manjaro/xfce | {{UserCmd|command=ls -l ~/iso-profiles/manjaro/xfce}} | ||
Let's take a closer look at the XFCE profile folder (marked above): | Let's take a closer look at the XFCE profile folder (marked above): | ||
| Line 57: | Line 57: | ||
The ''desktop-overlay'' folder looks like this: | The ''desktop-overlay'' folder looks like this: | ||
~/iso-profiles/manjaro/xfce/desktop-overlay/etc | {{UserCmdOutput|command=tree ~/iso-profiles/manjaro/xfce/desktop-overlay/etc|result= | ||
<pre> | |||
../iso-profiles/manjaro/xfce/desktop-overlay/ | |||
├── etc | |||
│ ├── fonts | |||
│ │ └── conf.d | |||
│ │ └── 70-no-bitmaps.conf | |||
│ └── lightdm | |||
│ ├── lightdm.conf | |||
│ └── lightdm-gtk-greeter.conf | |||
└── usr | |||
└── share | |||
└── icons | |||
└── default | |||
└── index.theme | |||
</pre> | |||
}} | |||
Go to this directory. | Go to this directory. | ||
{{UserCmd|command=cd ~/iso-profiles/manjaro/xfce/desktop-overlay/etc/}} | |||
Then create '''skel''' folder. This is where you can clone everything you see on your Desktop Screen to ISO. | Then create '''skel''' folder. This is where you can clone everything you see on your Desktop Screen to ISO. | ||
{{UserCmd|command=mkdir skel}} | |||
After the ISO has been successfully installed all files and folder in ''desktop-overlay'' folder get copied over to the installed system. This includes settings/config files but also themes and backgrounds/pictures. | After the ISO has been successfully installed all files and folder in ''desktop-overlay'' folder get copied over to the installed system. This includes settings/config files but also themes and backgrounds/pictures. | ||
| Line 82: | Line 94: | ||
Change all image directories to where your Custom Wallpaper was located at. For example: | Change all image directories to where your Custom Wallpaper was located at. For example: | ||
/usr/share/backgrounds/<YOUR IMAGE HERE> | |||
===Example=== | ===Example=== | ||
| Line 129: | Line 141: | ||
Go to this directory: | Go to this directory: | ||
~/iso-profiles/manjaro/xfce/desktop-overlay/ | {{UserCmd|command=cd ~/iso-profiles/manjaro/xfce/desktop-overlay/}} | ||
Then create <code>usr/share/backgrounds</code> and place your Custom Wallpaper at this directory. | Then create <code>usr/share/backgrounds</code> and place your Custom Wallpaper at this directory. | ||
{{UserCmd|command=mkdir ./usr/share/backgrounds}} | |||
{{UserCmd|command=cp ~/Pictures/Wallpapers/your-wallpaper.png ~/iso-profiles/manjaro/xfce/desktop-overlay/usr/share/backgrounds}} | |||
===profile.conf=== | ===profile.conf=== | ||
| Line 544: | Line 557: | ||
~/.config/manjaro-tools | ~/.config/manjaro-tools | ||
If the userconfig is present, ''manjaro-tools''/''buildiso'' will load the userconfig values | If the userconfig is present, ''manjaro-tools''/''buildiso'' will load the userconfig values. Best practice is to leave the systemwide file untouched. By default it is commented and shows just initialization values done in code. | ||
=Build your ISO= | =Build your ISO= | ||
Build your ISO with the following command: | Build your ISO with the following command: | ||
{{UserCmd|command=buildiso -p xfce}} | |||
You need to specify the name of your ISO profile after the <code>-p</code> argument. In this case, it is <code>xfce</code>. | You need to specify the name of your ISO profile after the <code>-p</code> argument. In this case, it is <code>xfce</code>. | ||
| Line 559: | Line 572: | ||
===Example:=== | ===Example:=== | ||
You can use arguments with the <code>buildiso</code> command for more build options: | You can use arguments with the <code>buildiso</code> command for more build options: | ||
{{UserCmd|command=buildiso -f -p xfce -b stable}} | |||
* <code>-f</code> let's you specify if you want the full ISO. If omitted a minimal ISO will be build. | * <code>-f</code> let's you specify if you want the full ISO. If omitted a minimal ISO will be build. | ||
* <code>-b</code> let's you specify the branch. You can also set this in your <code>manjaro-tools.conf</code> file. | * <code>-b</code> let's you specify the branch. You can also set this in your <code>manjaro-tools.conf</code> file. | ||
| Line 568: | Line 581: | ||
After a successful or failed build, you can get rid of most data (the "raw" ISO with all downloaded packages) by deleting this folder: | 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 /var/lib/manjaro-tools/buildiso/ | {{UserCmd|command=sudo rm -r /var/lib/manjaro-tools/buildiso/}} | ||
To clean your system of packages files of packages not installed on your system (this includes all the package files downloaded for your custom ISO): | To clean your system of packages files of packages not installed on your system (this includes all the package files downloaded for your custom ISO): | ||
paccache -ruk0 | {{UserCmd|command=sudo paccache -ruk0}} | ||
You can also manually look into | You can also manually look into | ||
| Line 580: | Line 593: | ||
and delete folders or files to your liking. If you want to delete all ISO images, package lists, and cached Xorg packages do: | and delete folders or files to your liking. If you want to delete all ISO images, package lists, and cached Xorg packages do: | ||
sudo rm -r /var/cache/manjaro-tools/ | {{UserCmd|command=sudo rm -r /var/cache/manjaro-tools/}} | ||
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. | 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. | ||
| Line 586: | Line 599: | ||
By default, your <code>manjaro-tools.conf</code> file is saved. If you want to delete it, use | By default, your <code>manjaro-tools.conf</code> file is saved. If you want to delete it, use | ||
{{UserCmd|command=rm -r ~/.config/manjaro-tools}} | |||