Skip to content

Latest commit

 

History

History
77 lines (53 loc) · 3.2 KB

README.md

File metadata and controls

77 lines (53 loc) · 3.2 KB

NateOS

NateOS is a lightweight Linux distribution that you can build from source. I made NateOS for fun and obviously not for serious stuffs.

lv_0_20240616182859.mov

What's in the box?

The NateOS distro includes the following programs and packages:

  • bottom - Yet another cross-platform graphical process/system monitor.
  • broot - Get an overview of a directory, even a big one.
  • BusyBox - BusyBox combines tiny versions of many common UNIX utilities into a single small executable.
  • GCC 4.6.1-2 - Toolchain that compiles code, links it with any library dependencies, converts that code to assembly, and then prepares executable files.
  • hex - Futuristic take on hexdump.
  • loc - Count lines of code quickly.
  • NodeJS 0.8.18-1 - A cross-platform, open-source JavaScript runtime environment that can run on Windows, Linux, Unix, macOS, and more.
  • OpenSSL - OpenSSL is a robust, commercial-grade, full-featured Open Source Toolkit for the TLS (formerly SSL), DTLS and QUIC (currently client side only) protocols.
  • pfetch - A pretty system information tool written in POSIX sh.
  • Python3.2 - Python is a high-level, dynamic, general-purpose programming language.

Getting Started

Building from Start

To get started in Ubuntu, follow the steps below.

  1. Clone the Repository: Pull the NateOS git repository to your local machine.

    # Clone NateOS build script
    git clone --depth 1 https://github.com/nthnn/NateOS
    cd NateOS
  2. Install rustup: Install rustup to manage the Rust toolchain. Follow the instructions provided here. Then add the Linux MUSL target for Rust compiler.

    # Default installation for `rustup`
    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
    
    # This will install the Linux MUSL for Rust compiler.
    rustup target add x86_64-unknown-linux-musl
  3. Switch to sudo Mode: Switch to sudo mode to ensure you have the necessary permissions for installation.

    sudo su
  4. Build NateOS: Run the build script to compile all necessary binaries, including the Linux kernel and BusyBox. Execute the following command:

    chmod +x build.sh
    ./build.sh

    This will generate nate_os.iso in the current working directory upon successful execution.

Emulating with QEMU

After successfully building NateOS, you can emulate it using QEMU. Ensure that QEMU, especially qemu-system-x86_64, is installed on your system. Run the following command:

sudo chmod +x emulate.sh
./emulate.sh

Cleaning Up

To remove all downloaded files and Git repositories created by the build.sh script, use the following command:

sudo chmod +x clean.sh
./clean.sh