Unverified Commit 0b968570 authored by Ian Douglas Scott's avatar Ian Douglas Scott
Browse files

Work on "getting started" section, for those not wanting to compile

parent 7770de48
......@@ -18,8 +18,10 @@
- [Will Redox replace Linux?](./introduction/will_redox_replace_linux.md)
- [About this Book](./introduction/about_this_book.md)
- [Getting started]()
- [Preparing Redox](./getting_started/preparing_the_build.md)
- [Getting started](./getting_started/getting_started.md)
- [Trying Redox in a virtual machine](./getting_started/try_vm.md)
- [Running Redox on real hardware](./getting_started/real_hardware.md)
- [Preparing the build](./getting_started/preparing_the_build.md)
- [Compiling Redox](./getting_started/compiling_redox.md)
- [Exploring Redox](./getting_started/exploring_redox.md)
- [Questions and feedback](./getting_started/asking_questions_giving_feedback.md)
......@@ -138,7 +140,6 @@
- [Environment]()
- [Fun]()
- [Running Redox on real hardware](./fun/real_hardware.md)
- [Setting up a Redox desktop]()
- [Customizing Redox]()
......
Getting started
===============
[Preparing the build](getting_started/preparing_the_build.html) has information about setting up your system to compile Redox, which is necessary if you want to contribute to Redox development.
If you aren't (currently) interesting in going through the trouble of building Redox, you can download the latest release. See the instructions for [running in a virtual machine](getting_started/try_vm.html) or [running on real hardware](getting_started/real_hardware.html).
Preparing the build.
====================
Preparing the build
===================
Woah! You made it so far, all the way to here. Congrats! Now we gotta build Redox.
......@@ -69,3 +69,8 @@ Rustup will install the `stable` version of Rust. To run Redox, you have to inst
$ rustup toolchain install nightly
$ rustup override set nightly
```
Next steps
----------
Once this is all set up, you can move on to [compiling Redox](getting_started/compiling_redox.html).
Trying Redox in a virtual machine
=================================
The ISO image is *not* the prefered way to run Redox in a virtual machine. Currently the ISO image loads the entire hard disk image (including unused space) into memory. In the future, the live disk should be improved so that doesn't happen.
Instead, you want to use the hard disk image, which you can find on the [release pages](https://github.com/redox-os/redox/releases) as a `.bin.gz` file. Download and extract that file.
You can then run it in your prefered emulator; this command will run qemu with various features Redox can use enables:
```
qemu-system-x86_64 -serial mon:stdio -d cpu_reset -d guest_errors -smp 4 -m 1024 -s -machine q35 -device ich9-intel-hda -device hda-duplex -net nic,model=e1000 -net user -device nec-usb-xhci,id=xhci -device usb-tablet,bus=xhci.0 -enable-kvm -cpu host -drive file=redox_VERSION.bin,format=raw
```
Change `redox_VERSION.bin` to the `.bin` file you just downloaded.
......@@ -6,3 +6,5 @@ This is the Redox book, which will go through (almost) everything about Redox: d
Please notice that this book is currently being written.
This book was written by Ticki with the help of LazyOxen, Steve Klabnik, ElijahCaine, and Jackpot51.
If you want to skip straight to trying out Redox, see [getting started](getting_started/getting_started.html).
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment