玄箱 Kuro Box Gentoo Kuro Box Gentoo
Help for users running Gentoo on the Kuro Box.
Home  |  About the Site  |  Contact Us

 

 

Installing Gentoo Beta 1 on the Kuro Box

This document is a step-by-step tutorial covering the installation of Gentoo Linux Beta 1 on the Kuro Box.

  1. Discussion
    1. What we hope to accomplish by installing Gentoo
    2. What is Gentoo Linux?
    3. The Pro's and Con's of Gentoo for the Kuro Box
    4. Does it require flashing the Kernel?
    5. How this will change your Kuro Box?
    6. Who ported Gentoo to the Kuro Box?
    7. Technical details of the Gentoo distribution
  2. Preparation
    1. Files you will need for the installation
    2. Skills you will need to complete this guide
    3. Software you will need
    4. Understanding the Kuro Box boot process and EM mode
    5. How the installation will proceed in broad terms
    6. What to do if something goes wrong during the installation
    7. Where to go for help
  3. Kuro Box EM Mode
    1. Getting into EM mode
    2. Logging into the EM mode Linux
    3. Upload and install some Linux programs to the EM mode flash RAM via FTP
    4. Setting the system clock's date and time
  4. Partitioning and Formatting the Hard Disk Drive
    1. Creating the partitions
    2. Formatting the partitions
  5. Installation of the base system
    1. Mounting the partitions
    2. Getting the files to the hard disk
    3. Installing into the /gentoo directory
    4. Chrooting in the Gentoo system
  6. Setting up and configuring Portage
    1. Configuring Portage
    2. Creating and populating the Portage directories
    3. Setting the portage profile
    4. Regenerating the Portage cache
    5. Testing that emerge works
  7. Setting up the File System
    1. Configuring fstab
    2. Creating mount points
  8. Configuring the Users
    1. Changing the password for the root user
    2. Adding new user accounts
  9. Configuring the Network
    1. Configure the eth0 interface
    2. Setting the hostname
  10. Configuring and Testing SSH
    1. Launching the SSH service
    2. Making a test login via SSH
    3. Setting SSH to start at boot
  11. Getting Ready to Reboot
    1. Double check networking settings
    2. Exiting the chrooted system and unmounting the directories
    3. Tell the Kuro Box to exit EM mode when it reboots and then shut it down
    4. Taking a break
  12. Booting the Gentoo Installation For the First Time
    1. ???
    2. ???
  13. Troubleshooting
    1. ???
    2. ???
  14. What to do next?
    1. ???
    2. ???

 

THIS SECTION IS UNFINISHED

THIS WAS ORIGINALLY BETWEEN STEPS 5 & 6

Base configuration of the Gentoo system

We have mainly four things to configure now, before we can reboot directly on the Gentoo system:

the package management system, Portage.
the fstab, so that the system knows what to mount and where
the root and users passwords
the network, including SSH

You may need to set your terminal at this point:
KURO-BOX-EM / # export TERM=vt100

To edit configuration files, use the "nano" editor:
KURO-BOX-EM / # nano /path/to/your/file
It is very basic, but should be easy to understand by anybody (keyboard shortcuts are written at the bottom of the screen).