so you wanna install yiffOS?
i am not responsible for any damages in any way that may be caused by the use or misuse of this guide.
WARNING! this guide assumes that you have at least some knowledge about linux and the linux command line,
and you will definitely need to be comfortable not using a gui for quite some time
table of contents
part 1 - base installation
first things first, you'll want to grab a copy of the latest yiffOS install image from
everyone's favorite realmicrosoft.com! this guide will
be using v2.0.0 which can be downloaded here.
using a virtual machine
if you're using a virtual machine for this install, you will need to mount the image somehow.
qemu usually works fine with the install image, although you may need to disable secure boot.
vmware, however, doesn't seem to like the image, and thus you may need to convert it to a
vmware format image by running something like
qemu-img convert -f raw -O vmdk v2_yiffOS-installer.img v2_yiffOS-installer.vmdk
you may also want to resize the image to a larger size than 3GiB to fix a later issue,
the process for doing so will not be covered here however as it varies between formats and
using a physical computer
if you're using a physical computer, you'll need to actually burn the image to a usb flash
drive and boot off of that. the easiest way to do this is to first check which device is the
flash drive by running
lsblk and then writing the image using
dd if=v2_yiffOS-installer.img of=/dev/sdX status=progress
once booted, you should see a screen that looks something like this:
you may be tempted to follow the onscreen instructions, BUT THERE ARE SOME IMPORTANT STEPS YOU
SHOULD TAKE FIRST!!!!
Kernel 5.16.11-yiffOS on an x86_64 (-)
welcome to Real Microsoft (c) 2004 yiff os installer v2.0.0
this image was published on 2022-04-11
user = root
pass = root
very secure (:
you should be automatically logged in, follow these steps to install yiffOS
make sure that you have a network connection; use ping and/or nmtui
use cfdisk to set up a basic efi layout (this installer was not designed for
use mkfs.fat -F32 on the EFI and mkfs for a filesystem of your choice on the
run ./install-yiffos </dev/sdXX (EFI partition)> </dev/sdXX (ROOT partition)>
and pray to god that it doesn't error out on you (:
yiffOS login: root (automatic login)
first of all, you'll need to download an updated install script as the one included with this
image is outdated and lacks some fixes that will be useful later.
you can download the version of the script that we will be using from
https://realmicrosoft.com/install-yiffos.sh by running
curl -O https://realmicrosoft.com/install-yiffos.sh
or you can download the latest version from github by running
curl -O https://raw.githubusercontent.com/realmicrosoft/yiffOS-install-script/main/install-yiffos.sh
(REMINDER THAT YOU ARE RUNNING THESE COMMANDS ON THE BOOTED YIFFOS INSTALLER IMAGE)
help! i have received an error stating i am out of disk space!
sooner or later, you'll get an error stating that you are out of disk space. this is
due to the small size of the yiffOS installer image. you'll need to resize the booted image
to the size of its enclosing media (either the usb flash drive or the actual .img file that your
vm is using). luckily, this is pretty simple and doesn't seem to cause issues from what i've seen.
all you need to do is run
fdisk -l and find the device that you want to resize, then
cfdisk /dev/sdX to resize the partition, and then run
resize2fs /dev/sdX to resize the filesystem.
after this, you'll just need to reboot and you should be good to go!
now that you've set up the new install script, you can go through the normal install process.
first, you need to run
cfdisk on the disk you want to install on. once here, you'll
need to create two partitions. one for the EFI partition and one for the root partition. you can
also optionally create a swap partition if you want to use it. the EFI partition should be 512MB
in size, and the root partition should be at least 3-4GB in size. the swap partition should be
equal to the size of your RAM.
once done, you should have something like this:
just hit the
Size: 5.0 GB, whatever bytes, whatever sectors
Label: gpt, identifier: whatever-whatever-whatever
Partition UUID: whatever-whatever-whatever
Partition type: whatever
Filesystem UUID: whatever-whatever
Mount point: /boot/efi
|[ Delete ]
||[ Resize ]
||[ Quit ]
||[ Type ]
||[ Help ]
||[ Write ]
||[ Dump ]
Write button and you should be good to go!
after closing cfdisk, you'll need to run
mkfs.fat -F32 /dev/sdXX on the EFI
partition in order to format it correctly. afterwards, you'll need to make a choice of which
filesystem you want to use on the root partition. we're going to be using btrfs as it is already
installed via the install script, however if you want to use another filesystem, you'll need
to install the appropriate package and then run
mkfs.whatever /dev/sdXX on the root.
ONE OTHER IMPORTANT STEP IF YOU'RE USING AN ALTERNATE FILESYSTEM:
remember to also install the appropriate package for that filesystem after installing yiffOS!
after running the installer, you'll be inside a chroot, so you'll need to run
and then proceed to run
INSTALL_ROOT=/mnt/root bulge i <appropriate package>
anyways, assuming you're using btrfs, you can now run
mkfs.btrfs /dev/sdXX to format
the root partition. if you get an error about another btrfs filesystem already existing, you can
mkfs.btrfs -f /dev/sdXX to overwrite it.
now the fun part!
now that you've created and formatted your partitions, pretty much all you have left to do is
./install-yiffos.sh /dev/<EFI PARTITION> /dev/<ROOT PARTITION>
and the installer will do almost all of the hard work for you!
after you've run the installer, just wait a bit (or maybe a bit longer, depending on your
cpu and internet speed) and you'll be prompted to set a root password. make sure it's something
that you can remember for at least the next 10 minutes or so because you'll need it to log in
to your new yiffOS install. IMPORTANT!!! DO NOT REBOOT YET!!! we still have some work to do!
(IF YOU PULLED FROM GITHUB, THIS **MIGHT BE** FIXED!!!!)
the install script has an issue in it that will cause dbus to not work, so we'll need to fix this.
luckily, it's a pretty simple fix, just run
(THE POSITIONING OF THE PARENTHESES IS VERY IMPORTANT!)
rm -R /var/run
ln -s /run /var/run
you'll need to do one other thing however, which is to reinstall dbus as we kinda just deleted
it. this isn't too hard either though, you'll just need to exit the chroot (which hopefully you
were still inside for the previous commands) and then run
INSTALL_ROOT=/mnt/root bulge i dbus