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