A fully functional desktop installation
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Dan a961f9e57a
cleanup: flashing the ISO file
1 year ago
airootfs updated mirrors 1 year ago
efiboot/loader updated to archiso v.49 2 years ago
syslinux updated to archiso v.50.1-1 2 years ago
LICENSE added content from .xyz domain 3 years ago
README.md cleanup: flashing the ISO file 1 year ago
packages.x86_64 updated to archiso v.52.1-1 1 year ago
pacman.conf updated to archiso v.46 2 years ago
profiledef.sh updated to archiso v.52.1-1 1 year ago


Still in progress. The ISO does not yet contain a complete configuration.
But it is already usable up to the desktop environment. Just without any PwOSS configuration.

With TOC at:
PwOSS - Wiki

Download ISO


Create your own ISO

You need a working Arch system to create the ISO.
You can use VirtualBox or download the ISO directly.



sudo pacman -S archiso git


Build your ISO

git clone https://git.pwoss.org/desktop/iso.git
cd /path/to/repo/ISO/
mkarchiso -v .

It is recommended to perform all the following steps as the root user with the umask set to 0022. If not, it is very likely that the live environment will have wrong file permissions.

Change profiledef.sh to your needs.


General options

Check mkarchiso -h.




Check the given ip address of your router for archiso.
Or nmap ...:
nmap -sn

Live ISO root user password is pwoss.


Necessary modifications

Boot into your Live ISO and change the script before running it!
nano pwoss-desktop.sh

You NEED to change:

  1. QDISKS="1" # Select the number "1" OR "2". If you have more than 2 hard drives, select 2.
  2. ENCRYPTION="YES" # Select "YES" OR "NO" whether you want encryption or not.

That's the absolute minimum you have to change. Of course you can also change the passwords etc.. But stay between the 2 lines!

############################# Change only between the 2 lines



If you are installing Arch on a HDD hard disk instead of an SSD hard disk, you must delete root_trim=yes from grub.

With Encryption:
nano etc/default/grub-luks

GRUB_CMDLINE_LINUX="cryptdevice=/dev/sda2:root root=/dev/vg0/root resume=/dev/vg0/swap root_trim=yes"

Without Encryption:
nano etc/default/grub



Desktop Environment

You can change the desktop environment.

Check Arch wiki for other desktop environments.

We will support KDE and Xfce in the future.



You can easily add or delete your own packages. Do NOT delete from package base to $MICROCODE (inlcuding $MICROCODE).



pwoss <[options]> -u [<username>]
pwoss <[options]> --username=[<username>]

-h     --help              show this message
-u     --username          set username          e.g. $USERNAME
-p     --password          set user password     e.g. $PASSWORD
-r     --root-password     set root password     e.g. $PASSWORDROOT
-e     --encryption        set encryption        e.g. $ENCRYPTION
-cr    --crypt-root        set root password     e.g. $CRYPTPWDROOT
-ch    --crypt-home        set home password     e.g. $CRYPTPWDHOME
-t     --timezone          set timezine          e.g. $TIMEZONE
-q     --quantity-disks    set numbers of hd     e.g. $QDISKS
-d     --disk              set install disk      e.g. $HARDDISK
-d2    --disk2             set home disk         e.g. $HARDDISK2


Install on Arch ISO

Boot into any Arch Linux ISO and type the following:

pacman -Sy git
git clone https://git.pwoss.org/desktop/iso.git
cd ISO/airootfs/




Minimal system

  • 512 megabyte (MB) of memory (RAM)
  • 13 gigabytes (GB) of hard disk space
  • A one gigahertz (GHz) processor
  • A broadband internet connection
  • x86_64-compatible machine


  • 2 gigabyte (GB) of memory (RAM)
  • 18 gigabytes (GB) of hard disk space
  • A 2 gigahertz (GHz) processor
  • A broadband internet connection
  • x86_64-compatible machine


System architecture

The following items are also recommended:

  • A reliable 1GB (or greater) USB stick

The USB Stick is necessary for the installation of the system. Also, having a reliable USB stick from a reputable brand will help ensure that the process goes smoothly.



(Optional) Etcher

Download Etcher to flash the ISO


How To


You have to align the boot-start to your USB-Stick.

Depending on your motherboard, you must press the "esc" or "f2" or "f12" or "end" key immediately after the PC starts.

Check your motherboard/computer manual if no button works or ask us.


Go to:

  1. Boot
  2. BOOT DEVICE PRIORITY (or similar)


Put the USB at the first place (with F5 and F6). Hit the button esc until save changes and reset. Hit enter and yes.

Reboot and choose Start: Boot Arch Linux (x86_64)

(After installing your operating system, you need to change back your BIOS settings)


Flashing the ISO file


Check of=/dev/sdX, if it's really your USB Stick!!!

sudo dd bs=4M if=~/Downloads/pwoss-desktop-*.iso of=/dev/sdX status=progress

You can also use Etcher if you prefer a graphical user interface (GUI).