installation

Installation

The simpledesktop environment can be installed by building the ISO image from the code, download and use the pre-built ISO image or install the awesome configuration only from source.

Use pre-built ISO image

Follow the steps below to install the SimpleDesktop from an ISO image file

1. Download the image file from here or build your own according as described in Build & Deploy

2. Copy the image onto an USB stick or whatever medium you want to use to install on your target system.
   dd bs=4M if=/path/to/your/image of=/dev/sdX

3. Start up the live image on the target system

4. edit the install.sh located in the root's home directory.

   1. Change the DEVICE to match your target system drive (e.g. /dev/sda, /dev/nvme0n1)
   2. Decide on your number of partitions, their size and type.
   3. Edit the lines containing sgdisk accordingly

5. execute the script ./install.sh (This changes root into the system for your target)

6. (Required for UEFI) install the uefi drive by runnning
   efibootmgr -c -d /dev/sdX -p Y -l EFI/syslinux/syslinux.efi -L "SysLinux"
   Where /dev/sdXY is the partition containing the bootloader (mainly equal to DEVICE with Y being the partition number of the EFI System Partition e.g.: /dev/nvme0n1pY or /dev/sdaY)
   The path to the .efi file has to be relative from the EFI System Partition!

7. (Optional) adjust the system to your custom needs

8. (Optional) execute the aftermath.sh script to download all configurations

9. exit sub-root system by pressing Ctrl+D and then unmount everything
   umount -R /mnt

10. Power off, remove USB drive and restart

You should be good to go.

Awesome Configuration

If you're only interested in the awesome configuration follow these steps

1. clone the repo into a folder (e.g. /tmp)
   git clone --recursive https://github.com/gnomengineer/simpledesktop.git /tmp/simpledesktop
2. copy the content from src folder to your local awesome directory. the directory has to exist
   cp -r /tmp/simpledesktop/src/* ~/.config/awesome/