Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nthnn/nateos
NateOS: My own lightweight Linux-based OS distribution, created for enjoyment and personal experimentation.
https://github.com/nthnn/nateos
linux linux-custom-image linux-distribution linux-distro linux-shell os
Last synced: about 21 hours ago
JSON representation
NateOS: My own lightweight Linux-based OS distribution, created for enjoyment and personal experimentation.
- Host: GitHub
- URL: https://github.com/nthnn/nateos
- Owner: nthnn
- Created: 2024-06-07T22:13:56.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-06-16T11:25:57.000Z (3 months ago)
- Last Synced: 2024-09-24T19:04:45.167Z (about 21 hours ago)
- Topics: linux, linux-custom-image, linux-distribution, linux-distro, linux-shell, os
- Language: Shell
- Homepage:
- Size: 72.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# NateOS
NateOS is a lightweight Linux distribution that you can build from source. I made NateOS for fun and obviously not for serious stuffs.
https://github.com/nthnn/NateOS/assets/90981832/9730782a-9d5a-4625-972d-35414ed1624b
## What's in the box?
The NateOS distro includes the following programs and packages:
- [bottom](https://github.com/ClementTsang/bottom) - Yet another cross-platform graphical process/system monitor.
- [broot](https://github.com/Canop/broot) - Get an overview of a directory, even a big one.
- [BusyBox](https://www.busybox.net/about.html) - BusyBox combines tiny versions of many common UNIX utilities into a single small executable.
- [GCC 4.6.1-2](https://gcc.gnu.org/) - Toolchain that compiles code, links it with any library dependencies, converts that code to assembly, and then prepares executable files.
- [hex](https://github.com/sitkevij/hex) - Futuristic take on hexdump.
- [loc](https://github.com/cgag/loc) - Count lines of code quickly.
- [NodeJS 0.8.18-1](https://nodejs.org/en) - A cross-platform, open-source JavaScript runtime environment that can run on Windows, Linux, Unix, macOS, and more.
- [OpenSSL](https://github.com/openssl/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](https://github.com/dylanaraps/pfetch) - A pretty system information tool written in POSIX sh.
- [Python3.2](https://www.python.org/) - 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.
```bash
# 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](https://www.rust-lang.org/tools/install). Then add the Linux MUSL target for Rust compiler.
```bash
# 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.
```bash
sudo su
```
4. **Build NateOS**: Run the build script to compile all necessary binaries, including the Linux kernel and BusyBox. Execute the following command:
```bash
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:
```bash
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:
```bash
sudo chmod +x clean.sh
./clean.sh
```