Blackbox Linux

A minimal, ultra-lightweight Linux distribution. ( This Project is in Alpha. Only use for tteating purposes. Many fatures listed are not available yet. )

---

About

Blackbox Linux is a challenge for Linux professionals and enthusiasts. If you can master this minimal OS with only essential Unix utilities, you've truly proven your Linux expertise.

Features

• Minimal footprint - Only the essentials included

• Lightweight - Perfect for resource-constrained environments

• Pure Linux - No bloat, no package managers, no hand-holding

  

What's Included

• ls - List directory contents
• cp - Copy files
• mv - Move/rename files
• make - Build automation
• tar - Archive creation and extraction
• wget - To fetch files

What's NOT Included

• Package managers
• Pre-built binaries
• Desktop environments
• Additional utilities
• No Documentation

Getting Started

Currently, pre-built ISO files are available for alpha. Along with Build Scripts. After that only Build-Script will be Provided.

Installation

Make sure you are on ARCH LINUX if using build script

Download the latest ISO from the Releases page.

---

If using Script FOllow below

Just run chmod +x bb.sh and then sudo ./bb.sh

If you face this error while running script:

make[3]: *** [scripts/Makefile.build:243: arch/x86/boot/compressed/cpuflags.o] Error 1
make[3]: *** [scripts/Makefile.build:243: arch/x86/boot/compressed/cmdline.o] Error 1
make[3]: *** [scripts/Makefile.build:243: arch/x86/boot/compressed/early_serial_console.o] Error 1
make[3]: *** [scripts/Makefile.build:243: arch/x86/boot/compressed/error.o] Error 1
make[2]: *** [arch/x86/boot/Makefile:114: arch/x86/boot/compressed/vmlinux] Error 2
make[1]: *** [arch/x86/Makefile:283: bzImage] Error 2
make: *** [Makefile:234: __sub-make] Error 2
[✗] Kernel compilation failed — see /home/aarav/blackbox/blackbox-build/build.log
{ark} (aarav) : ~/blackbox $ 

Then Got to /blackbox-build/linux-6.6.30 and run sudo make KCFLAGS="-std=gnu17" KCPPFLAGS="-std=gnu17" -j$(nproc)

Then Re-run the script again.

---

If you face thiswhile running the script:

  Absolute path to config script (UDHCPC_DEFAULT_SCRIPT) [/usr/share/udhcpc/default.script] (NEW) 

Just press Enter

---

If you face this error while running script:

[✗] BusyBox applet 'sh' (user) is NOT compiled in.
  Check .config for CONFIG_SH=y
  and rebuild: rm /blackbox-build/busybox-1.36.1/busybox then re-run this script.

Then Got to /blackbox-build/busybox-1.36.1 and run rm busybox > DO NOT run this command as sudo.

It will ask rm: remove write-protected regular file '/home/aarav/blackbox/blackbox-build/busybox-1.36.1/busybox'? Just press enter

Then Re-run the script again.

---

If you face this error while running script:

[✗] GNU make compilation failed — see /home/aarav/blackbox/blackbox-build/build.log

Then Got to blackbox-build/make-4.4.1 and run sudo ./configure --host=x86_64-linux-musl CC=musl-gcc CFLAGS="-g -O2 -std=gnu17" then sudo make

Then Re-run the script again.

---

At the end You will see this.

[+] ISO validated: 35M

  ╔════════════════════════════════════════════════════════════╗
  ║             BlackBox Linux — Build Complete                ║
  ╠════════════════════════════════════════════════════════════╣
  ║  ISO      : 35M  blackbox-linux.iso                       ║
  ║  Kernel   : 3.6M  (bzImage)                               ║
  ║  Initrd   : 580K                                          ║
  ║  Arch     : x86                                           ║
  ║  Distro   : arch                                          ║
  ╠════════════════════════════════════════════════════════════╣
  ║  User commands  : sh  ls  cp  mv  wget  tar  make         ║
  ║  Internal only  : ifconfig  udhcpc  route  mount  mdev    ║
  ╠════════════════════════════════════════════════════════════╣
  ║  Test with QEMU:                                           ║
  ║    qemu-system-x86_64 -m 256M -cdrom blackbox-linux.iso \  ║
  ║      -boot d -net nic,model=virtio -net user -nographic    ║
  ╠════════════════════════════════════════════════════════════╣
  ║                                                            ║
  ║                 Boot. Survive. Build.                      ║
  ║                                                            ║
  ╚════════════════════════════════════════════════════════════╝

  Full log: /home/aarav/blackbox/blackbox-build/build.log

Boot your ISO in QEMU. DO NOT GO BARE METAL.

Contribute

Found an issue? This is your opportunity to prove your Linux prowess!

Please report bugs and issues in the Issues tab so they can be patched.

---

Challenge accepted? Install Blackbox Linux and show the world you're a true Linux pro.