Running Dominos

There are many options for running Dominos. You can run it on real (x86) hardware, a virtual machine, or a simulator. No matter what the platform, you will need to set up a boot loader to run the system, or boot from a device which is already set up.

ISO Image

The simplest option is to boot from a ready-made device. You can download or make an ISO image which has everything set up for you. You can now boot from this image directly (in Bochs, QEMU or VirtualBox for example) or you can burn the image to physical media (a real CD or DVD) and boot that way.

1. To make an ISO image, download and set up the development environment as explained here.
2. Now run 'make' from the top level directory, which will build everything and create 'dominos.iso'

GRUB Entry

A slightly more complicated (and more permanent) option is to configure a multiboot-compliant bootloader (such as GRUB or GRUB2) with a menu entry. On an Ubuntu or Debian system, that would mean

1. editing the /etc/grub.d/40_custom file, and adding an entry similar to the one below:
2. Make sure to copy joel4.elf and init.cpio to the /boot directory on the correct partition
3. Reboot and select Dominos GRUB2 entry menuentry 'DominOS/Joel4' --class l4 --class os { recordfail insmod gzio insmod part_msdos insmod ext2 set root='(hd0,msdos6)' multiboot /boot/joel4.elf module /boot/init.cpio }