CRUX : Home

Home :: Documentation :: Download :: Development :: Community :: Wiki :: Ports :: Bugs :: Links :: About



Many common problems are answered in the FAQ document, so if you experience problems please check whether contains answers to your questions already.

If you have further questions, there's a dedicated mailing list for CRUX, and an IRC channel. Actual information about these can be found on the Community page of our wiki.

GRUB installation


Installing a new boot manager is like modifying the partition table using fdisk or installing a new system kernel. Please create a rescue boot disk first!

CRUX comes with a heavily patched version of grub. Use it at your own risk!


After installation you need to copy the stage files to /boot/grub/:

# cp /usr/share/grub/i386-pc/* /boot/grub/

(Of course, you can choose another location as described above but this guide assumes that you use /boot/grub. Normally you need only the files stage1 and stage2. Please read the grub documentation if you don't know why: and

Now it's time to create your own "boot menu":

# # Copy sample file
# cp /boot/grub/grub.conf.sample /boot/grub/grub.conf
# # Modify it for your system 
# vi /boot/grub/grub.conf

For more information about setting up your own grub boot menu file:

Last but not least, install/enable the boot manager:

# # Run grub
# grub
grub> root (hdX,Y)
grub> setup (hdX)
grub> quit

Please correct the path and device names according to your configuration. Also see In the example above, X and Y need to be replaced with your hard drive and grub partition.