Skip to content

Latest commit

 

History

History
49 lines (45 loc) · 2.4 KB

BUILD.md

File metadata and controls

49 lines (45 loc) · 2.4 KB
Raw

So, how do you even build this?

GitHub Releases:

You can simply download the latest compile from releases.

Mac (Also works on Hackintoshed systems):

  1. Git clone this repo.
  2. Install rustup from one of these sources:
    • Homebrew (recommended for most users; macOS 12 or newer)
      • Install homebrew by pasting the command from the page
      • Run brew install rustup
      • And run rustup-init to initialize the setup.
    • rustup.rs (macOS 11 and under)
      • Simply run the command from the page to start the setup.
  3. Hit 2 to customise during install and press enter.
  4. Hit enter again.
  5. Type nightly and hit enter.
  6. Type complete and hit enter.
  7. Type y for PATH var modification and hit enter.
  8. Hit enter again.
  9. Run . "$HOME/.cargo/env".
  10. Run cargo install bootimage.
  11. In LUM-MARINER/LUM, run cargo bootimage --release && qemu-system-x86_64 --drive format=raw,file=target/x86_64-unknown-none/release/bootimage-LUM.bin. This currently only works on BIOS QEMU, not UEFI QEMU.

Linux (Currently only tested on Ubuntu, follow at your own risk if on other distros):

  1. Git clone this repo.
  2. Install rustup from rustup.rs. (If you are on Ubuntu, snap rustup is broken and will not work with this.)
  3. Hit 2 to customise during install.
  4. Hit enter.
  5. Type nightly and hit enter.
  6. Type complete and hit enter.
  7. Type y for PATH var modification and hit enter.
  8. Hit enter again.
  9. Run . "$HOME/.cargo/env".
  10. Run cargo install bootimage.
  11. Run rustup component add llvm-tools-preview.
  12. In LUM-MARINER/LUM, run cargo bootimage --release && qemu-system-x86_64 --drive format=raw,file=target/x86_64-unknown-none/release/bootimage-LUM.bin. This currently only works on BIOS QEMU, not UEFI QEMU.

Windows (Requires Build Tools):

  1. Git clone this repo.
  2. Install rustup from rustup.rs.
  3. Hit 2 to customise during install.
  4. Hit enter.
  5. Type nightly and hit enter.
  6. Type complete and hit enter.
  7. Type y for PATH var modification and hit enter.
  8. Hit enter again.
  9. Run cargo install bootimage
  10. In LUM-MARINER/LUM and in CMD (must be CMD as Powershell doesn't like this command), run cargo bootimage --release && "C:\Program Files\qemu\qemu-system-x86_64.exe" --drive format=raw,file=target/x86_64-unknown-none/release/bootimage-LUM.bin. This currently only works on BIOS QEMU, not UEFI QEMU.