diff options
author | Silvio Rhatto <rhatto@riseup.net> | 2017-10-01 17:20:27 -0300 |
---|---|---|
committer | Silvio Rhatto <rhatto@riseup.net> | 2017-10-01 17:20:27 -0300 |
commit | 80071d0ed7ee04054ad244d89ec6fbe2bd3ca7ba (patch) | |
tree | 9250557d8db439de911578586f6152c44f8b3792 /tutorial.md | |
parent | e39d8ff383a677635745f9ac025757718edbf397 (diff) | |
download | bootless-80071d0ed7ee04054ad244d89ec6fbe2bd3ca7ba.tar.gz bootless-80071d0ed7ee04054ad244d89ec6fbe2bd3ca7ba.tar.bz2 |
Change markdown extension to .md
Diffstat (limited to 'tutorial.md')
-rw-r--r-- | tutorial.md | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/tutorial.md b/tutorial.md new file mode 100644 index 0000000..a504586 --- /dev/null +++ b/tutorial.md @@ -0,0 +1,37 @@ +[[!meta title="Bootless: barebones tutorial"]] + +This tutorial helps you to build a Grub USB stick to boot your operating systems. + +Create basic folder structure +----------------------------- + + mkdir -p bootless/boot/{grub,custom} + wget https://git.fluxo.info/bootless/plain/templates/grub.cfg -O bootless/boot/grub/grub.cfg + wget https://git.fluxo.info/bootless/plain/templates/custom.cfg -O bootless/boot/custom/custom.cfg + +Customize +--------- + +Please check and customize the downloaded configuration above. The defaults: + +* Have examples to help customizations. +* Allows you to load into Grub and boot your OS using the grub shell. +* Provides two functions, `bootfde` and `bootimg` to simplify booting your encrypted system. + +You may also place custom images into the USB stick -- with the drawback to have to keep them up-to-date: + + cp -r /boot /tmp/bootless/custom/debian + +Create a bootable image +----------------------- + + grub-mkrescue -o bootless.iso bootless + +Record the image into the USB stick +----------------------------------- + +**WARNING!** This will irrevocably replace the contents of your USB stick. Pay +attention to get the right device. If your USB stick is attached to your +computer and reachable through `/dev/sdb`, you just have to run + + sudo dd if=bootless.iso of=/dev/sdb |