Gentoo installation script
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Readme.md 3.0KB

1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
1 year ago
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
  1. `gein` (GEntoo INstaller) is a script for automating the installation of
  2. my ideal Gentoo Linux system. This repository contains the following:
  3. * `gein.sh`, the installation script
  4. * `etc/`, configuration files
  5. * `usr/`, kernel configurations
  6. ## Warnings
  7. * Using `gein` is not a replacement for reading the Gentoo Handbook. If
  8. anything is not understood, please consult the Gentoo Handbook for
  9. your system before submitting an issue.
  10. * Be sure to review this repository in it's entirety, including the
  11. warnings at the top of `gein.sh`.
  12. * You must manually partition your disks and mount the partitions.
  13. * No web browser, office suite, or other applications are included by
  14. default.
  15. ## FAQ
  16. #### "How much about Gentoo will I need to know to use gein?"
  17. I would suggest reading the Gentoo Handbook and every file in this
  18. project before proceeding.
  19. #### "I keep getting boot failures after installing in a VirtualBox VM?"
  20. Remove the virtual disk drive from the boot order and restart.
  21. #### "The display is lagging when using LXQT on my Nvidia GPU?"
  22. Run `eselect opengl set nvidia` as root.
  23. ## Installing
  24. You may use this script as-is by performing the following steps:
  25. 1. Download the Gentoo install cd (or any Live distribution) for your architecture. Only
  26. amd64 is currently defined. Create an issue with the output of
  27. `uname -a` for it to be added to the script.
  28. 2. Write the ISO to a disk or USB drive and boot from it.
  29. $ dd if=~/Downloads/install-*.iso of=/dev/sdX
  30. $ reboot
  31. 3. Partition and mount your disks. Note that this example assumes that
  32. you will be using a single partition and later installing GRUB to the
  33. MBR. Note that if you aren't using the Gentoo installation CD, you will
  34. need to `mkdir /mnt/gentoo` before proceeding.
  35. $ fdisk /dev/sdX
  36. $ mkfs.ext4 /dev/sdX
  37. $ mount /dev/sdX1 /mnt/gentoo
  38. 4. Download and run `gein.sh`
  39. $ wget https://gein.io/gein.sh
  40. $ sh gein.sh
  41. gein: Linux-based derivative of Gentoo
  42. bootstrap Bootstrap the stage3 tarball
  43. Post-bootstrap:
  44. minimal Headless installation
  45. desktop Desktop installation
  46. 5. Uncomment and set the `PartitionBoot` & `VideoCards` variables. Both
  47. MUST be set or `gein.sh` will exit. If you don't need any video support,
  48. then set `VideoCards` to false.
  49. PartitionBoot="/dev/sda"
  50. VideoCards="false"
  51. 6. Start the bootstrap. Upon completion, the script will chroot into
  52. `/mnt/gentoo` so we may proceed to the next step.
  53. $ sh ./gein.sh bootstrap
  54. 7. Install the desired target:
  55. $ sh ./gein.sh minimal
  56. 8. Wait a few hours. You will be prompted as few times as possible though
  57. prompts are at the very beginning or end of the process.
  58. 9. Enjoy your new Gentoo installation!
  59. ## Customizing
  60. If you would like to create your own ideal Gentoo system using this
  61. script, you may do so by:
  62. 1. Forking https://github.com/jcmdln/gein
  63. 2. Modify the configuration files as desired
  64. 3. Update the `Source` URL in `gein.sh`
  65. 4. Update the `CONFIG()` function to represent your configuration