These are the install instructions for Soup64 OS Release 1! Using Linux: 1. Please read the requirments on the Soup64 page! 2. Create a parttion on your drive with GParted that's at least 20 GB. Use the ext4 file system, and label the partiion so you know what it is. Take note what location the new drive is (/dev/sdXY). # sudo gparted 3. Create the folder /mnt/soup64 and then mount the partition there. Then change your present working directory (PWD). NOTE: Replace sdXY with your partitions name, such as /dev/sda2 # sudo mkdir /mnt/soup64 # sudo mount /dev/sdXY /mnt/soup64 # cd /mnt/soup64 4. If you haven't already, download the Soup64 base system. Then, expand it to the PWD. NOTE: Your download will probably be in /home/USER/Downloads/, replacing USER with your username # sudo tar xpvf /your/soup64/download -C /mnt/soup64/ 5. If you'd like, you can at this point delete your download. Next, create an environment variable to point to Soup64. Then, prepare the system to chroot into it. # export SOUP=/mnt/soup64 # sudo mount -v --bind /dev $SOUP/dev # sudo mount -vt devpts devpts $SOUP/dev/pts -o gid=5,mode=620 # sudo mount -vt proc proc $SOUP/proc # sudo mount -vt sysfs sysfs $SOUP/sys # sudo mount -vt tmpfs tmpfs $SOUP/run 6. Chroot into the Soup64 system. # chroot "$SOUP" /usr/bin/env -i \ HOME=/root TERM="$TERM" \ PS1='(lfs chroot) \u:\w\$ ' \ PATH=/bin:/usr/bin:/sbin:/usr/sbin \ /bin/bash --login 7. You are now in the Soup64 as the root user. Set a new root password so that your system is protected!! # passwd 8. Set a unique hostname for your system. This must be different from every system on your network! NOTE: Replace *HOSTNAME* with the name you wnat to use. It must start with a letter or number and have no spaces!! # echo *HOSTNAME* > /etc/hostname Now set your machine ID for Systemd and D-Bus # systemd-machine-id-setup 9. Set the timezone. First, determine what tz timezone you live in wih the tzselect command, then link a file based on your location. The folloeing example is based on living in the Pacific Standard Time zone. Replace "America/Los_Angeles" with your zone. # rm /etc/localtime # tzselect # ln -s /usr/share/zoneinfo/America/Los_Angeles /etc/localtime 10. Create an /etc/fstab file. This will require some investigation. Use the blkid command to determine what UUID Soup64 is assigned, then follow the format to add to fstab, be sure to replace the example UUID for yours. # blkid # echo "UUID='2cd4fd5a-8bf4-4c0d-8e45-daf3706382ea' / ext4 defaults 1 1" > fstab 11. Make your user account. Replace *USER* with the username that you want to use. NOTE: adding the user to the wheel group will give it sudo permissions, so if you are creating a user that you don't want to have admin privliges, remove wheel from the list. # useradd -G disk,lp,audio,usb,cdrom,mail,wheel,scanner -m -s /bin/bash -U *USER* 12. At this point, if you have grub already installed, you can update it and booot into the system and complete the rest of the commands running Soup64. If it is not installed and you wish to boot to Soup64, use these commands to install it. Then create a configuration file. NOTE: Replace /dev/sdX with the drive Soup64 is on. DO NOT add the number of what partition Soup64 is on, this will install Grub incorrectly # grub-install /dev/sdX --target=i386-pc # grub-mkconfig -o=/boot/grub/grub.cfg 13. Either reboot and login as your created user, or simply login from the chroot. # login *USER* 14. If you have an NVIDIA graohics card, you need to install the NVIDIA driver to use. Download then run the NVIDIA installer. NOTE: If you have an AMD or Intel card, you do not need to worry about drivers. NOTE2: This is the current driver as of now, but go to https://www.nvidia.com/Download/index.aspx to search for the latest. Choose your card, then pick Linux x64 for the OS. # wget https://us.download.nvidia.com/XFree86/Linux-x86_64/460.67/NVIDIA-Linux-x86_64-460.67.run # chmod +x NVIDIA-Linux-x86_64-460.67.run # bash ./NVIDIA-Linux-x86_64-460.67.run 15. Currently, your system does not have an installed desktop experience. Currently, Grays Communications only provides and recommends Gnome and Mate, with KDE and LXDE on its way. You can install both or one of the desktops to use. Use apt to update current packages and then install the desktop. # sudo apt update && sudo apt upgrade # sudo apt install gnome OR # sudo apt install mate OR # sudo apt install gnome mate 16. Next, you need to pick whether to use GDM or LightDM as your display manager. Currently, we recommend GDm as LightDM has more major bugs. NOTE: If you have an NVIDIA graphics card, GDM will glitch upon booting, and the simple fix that we have found is to switch tty's by holding ctrl+atl+f4 then holding ctrl+atl+f1 to go back, and it should launch GDM. We will be working on a fix soon. # sudo systemctl enable gdm OR # sudo apt install lightdm # sudo systemctl enable lightdm 17. Use the following command to list applications you can install that are not installed already. We then list example applications you can install that are popular. # apt list VLC # sudo apt install vlc LibreOffice # sudo apt install libreoffice Firefox # sudo apt install firefox Java 11 # sudo apt install jdk11 18. Reboot the system and teh GUI should now be working, along side any apps you installed too. Enjoy! Remember to submit any bugs to our GitHub page. Using Windows (NOT RECOMMENDED): 1. Please read the requirements on the Soup64 page! 2. Open up Disk Management and create a partition. Windows will only be able to create an NTFS file system. Make sure it has at least 20GB of space! 3. If you haven't already, download the Soup64 base package. Then, extract the file into the file system you just created. 4. At this point if you'd like, you can delete the file you downloaded. Things now get slightly complicated. You need to install Windows Subsystem for Linux (WSL). Follow the instructions here: https://docs.microsoft.com/en-us/windows/wsl/install-win10 5. Once in WSL, you need to chroot into the Soup64 system. Set an enviorment variable to the Soup64 system. This will require some investigation using File Explorer. Take note what drive letter Soup64 is assigned, then replace DLETTER with the drive letter. # export SOUP=/mnt/DLETTER # chroot "$SOUP" /usr/bin/env -i \ HOME=/root TERM="$TERM" \ PS1='(lfs chroot) \u:\w\$ ' \ PATH=/bin:/usr/bin:/sbin:/usr/sbin \ /bin/bash --login 6. Now please follow the instructions using Linux from numbers 7 - 11, then come back here, 7. PLEASE NOTE: Installing Grub this way has NOT been tested and we have no idea if it will work!! If you still want to proceed, then use the blkid command to determine what path your Soup64 drive is. Look for /dev/sdX, with X being a letter such as a or b. DO NOT enter sdXY with a number, as this will break Grub. # blkid # grub-install /dev/sdX--target=i386-pc # grub-mkconfig -o=/boot/grub/grub.cfg 8. At this point, you should be able to reboot and login to Soup64, then follow the instructions from the Linux instructions from 14 till the end. Good luck, especially as we do not recommend using Windows to install Soup OS.