J-OS Documentation

Welcome to the J-OS documentation. Here you will find instructions on building and installing J-OS, a lightweight Linux distribution based on Linux From Scratch (LFS).

Why LFS-Based?

J-OS is built upon the Linux From Scratch (LFS) project, which provides personalization and complete user control over the operating system. Additionally, LFS offers educational material that explains the inner workings of a Linux-based OS. We highly recommend visiting the Linux From Scratch website and following their steps before proceeding with J-OS.

Building J-OS (Recommended)

Note: Before building J-OS, ensure that your system meets the following requirements:

  1. Download the J-OS build file and save it in a convenient location.
  2. Open a terminal and navigate to the directory where you saved the J-OS build file.
  3. Execute the following command to initiate the build process:
sudo ./mylfs.sh --build-all

Monitor the terminal as the build process proceeds.

Once the build is complete, it is recommended to test the system using a CLI-based virtual machine (VM) before installing it on a physical drive. To run the CLI-VM, execute the following command:

sudo ./runqemu.sh

If you see the Linux logo displayed in the CLI, the system is working correctly, and you can proceed with the installation process (on a VM or physical drive).

Recommended Installation Process (Virtual Machine/Physical Drive)

  1. Open a terminal or use the existing terminal from the previous steps.
  2. [Add installation steps specific to J-OS]