# en10/tinyboxlinux architecture

> Architecture diagram of the GitHub repository en10/tinyboxlinux, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/en10/tinyboxlinux
- Repository: https://github.com/en10/tinyboxlinux

## Overview

TinyBox Linux is a minimal Linux distribution: users run a prebuilt ISO or kernel-plus-initramfs image in QEMU, reaching a ToyBox shell and utilities with documented networking support. The README also describes the ISO as packaging the kernel and initramfs with Syslinux. No source excerpts were provided, so the graph is limited to relationships documented in the README; it does not infer boot-time calls or component internals.

Main entry points: [`cd-root/image.iso`](https://github.com/en10/tinyboxlinux/blob/main/cd-root/image.iso) (Bootable ISO), [`bootfiles/initramfs.cpio.gz`](https://github.com/en10/tinyboxlinux/blob/main/bootfiles/initramfs.cpio.gz) (ToyBox initramfs), [`bootfiles/bzImage`](https://github.com/en10/tinyboxlinux/blob/main/bootfiles/bzImage) (Linux kernel), [`cd-root/isolinux.bin`](https://github.com/en10/tinyboxlinux/blob/main/cd-root/isolinux.bin) (ISOLINUX boot files)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_boot["Boot artifacts"]
  node_kernel["Linux kernel"]
  node_iso["Bootable ISO<br/>[image.iso]"]
  node_isolinux["ISOLINUX boot files<br/>[isolinux.bin]"]
end

subgraph group_userland["Userspace"]
  node_initramfs["ToyBox initramfs<br/>[initramfs.cpio.gz]"]
  node_toybox["Shell and utilities<br/>[initramfs.cpio.gz]"]
end

subgraph group_network["Networking"]
  node_networking["Network support<br/>[initramfs.cpio.gz]"]
end

node_user(("User"))
node_qemu["QEMU"]

node_user -->|"runs image"| node_qemu
node_qemu -->|"runs ISO"| node_iso
node_qemu -->|"runs kernel"| node_kernel
node_qemu -->|"loads initrd"| node_initramfs
node_iso -->|"packages"| node_kernel
node_iso -->|"packages"| node_initramfs
node_iso -->|"uses boot files"| node_isolinux
node_initramfs -->|"provides userspace"| node_toybox
node_initramfs -->|"includes support"| node_networking

click node_kernel "https://github.com/en10/tinyboxlinux/blob/main/bootfiles/bzImage"
click node_initramfs "https://github.com/en10/tinyboxlinux/blob/main/bootfiles/initramfs.cpio.gz"
click node_toybox "https://github.com/en10/tinyboxlinux/blob/main/bootfiles/initramfs.cpio.gz"
click node_networking "https://github.com/en10/tinyboxlinux/blob/main/bootfiles/initramfs.cpio.gz"
click node_iso "https://github.com/en10/tinyboxlinux/blob/main/cd-root/image.iso"
click node_isolinux "https://github.com/en10/tinyboxlinux/blob/main/cd-root/isolinux.bin"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_kernel,node_iso,node_isolinux,node_user toneBlue
class node_initramfs,node_toybox toneAmber
class node_networking toneMint
class node_qemu toneIndigo
```

## Components

### Boot artifacts

- [Linux kernel](https://github.com/en10/tinyboxlinux/blob/main/bootfiles/bzImage): `bootfiles/bzImage`
- [Bootable ISO](https://github.com/en10/tinyboxlinux/blob/main/cd-root/image.iso): `cd-root/image.iso`
- [ISOLINUX boot files](https://github.com/en10/tinyboxlinux/blob/main/cd-root/isolinux.bin): `cd-root/isolinux.bin`

### Userspace

- [ToyBox initramfs](https://github.com/en10/tinyboxlinux/blob/main/bootfiles/initramfs.cpio.gz): `bootfiles/initramfs.cpio.gz`
- [Shell and utilities](https://github.com/en10/tinyboxlinux/blob/main/bootfiles/initramfs.cpio.gz): `bootfiles/initramfs.cpio.gz`

### Networking

- [Network support](https://github.com/en10/tinyboxlinux/blob/main/bootfiles/initramfs.cpio.gz): `bootfiles/initramfs.cpio.gz`

### Other components

- **User**
- **QEMU**

## Connections

- User → QEMU: runs image (evidence: `README.md`)
- QEMU → Bootable ISO: runs ISO (evidence: `README.md`)
- QEMU → Linux kernel: runs kernel (evidence: `README.md`)
- QEMU → ToyBox initramfs: loads initrd (evidence: `README.md`)
- Bootable ISO → Linux kernel: packages (evidence: `README.md`)
- Bootable ISO → ToyBox initramfs: packages (evidence: `README.md`)
- Bootable ISO → ISOLINUX boot files: uses boot files (evidence: `README.md`)
- ToyBox initramfs → Shell and utilities: provides userspace (evidence: `README.md`)
- ToyBox initramfs → Network support: includes support (evidence: `README.md`)
