---

pearOS-debian-base 📌

It is pearOS, but with Debian Base. Yes! It uses vanilla debian, less bugs, easier, better etc.

Why? 📌

A Debian base means the vast APT package ecosystem, a more conservative/stable release cadence, and broader out-of-the-box hardware support than a rolling-release base — while keeping the same pearOS look, feel and app set.

Ok... How do I build it? 📌

build-iso.sh is a generic Debian live-ISO engine: package list, extra APT repo, package selection, branding and boot menu/theme names all come from a profile under profiles/<name>/, not from the script itself.

sudo ./build-iso.sh

Note: The build script must be run as root since it needs to create chroot environments and install packages — if not already root, it re-executes itself via pkexec (or sudo as a fallback).

It accepts the following flags:

• --profile <name> Distro profile to build, from profiles/<name>/. Default: pear (Pulsar OS).
• --branch stable, replacing stable with forky or rolling (mapped to Debian's trixie, forky and testing suites respectively).
• --local to package from the packages in the /PKG folder, which must be in the same folder that contains the /ISO folder
• --nvidia Build ISO image with privative drivers (BROADCOM, NVIDIA, etc...)
• --clean-base Delete the cached base Debian chroot and rebuild it from scratch.
• --clean-target Delete the working target rootfs and re-clone it from the base cache, even if one already exists from a previous run.
• --chroot Drop into an interactive shell inside the target rootfs right before compression (proc/sys/dev are still mounted), then stop -- never falls through to packaging the ISO in the same run. The target rootfs is never deleted automatically: if one already exists (from an earlier --chroot session, a finished build, or days ago), any run -- --chroot or plain -- reuses it as-is and skips straight past repo/package install. Pass --clean-target to force a fresh one.

The ISO boots via Ploader (pearOS's own rebrand of rEFInd 0.14.1, a prebuilt EFI binary+theme vendored under profiles/<name>/ploader/) for UEFI, with syslinux as the BIOS/legacy fallback -- there's no bootloader choice to make.

Dependencies: 📌

Building from an Arch Linux / CachyOS / Manjaro host

sudo pacman -S --needed \
  squashfs-tools syslinux xorriso mtools dosfstools \
  binutils libisoburn sassc imagemagick psmisc \
  fakeroot rsync jq curl unzip wget git

You'll also need mmdebstrap from the AUR (e.g. yay -S mmdebstrap), since it bootstraps the Debian chroot regardless of the host distro.

Building from a Debian / Ubuntu / Pop!_OS host

sudo apt-get install -y \
  mmdebstrap squashfs-tools isolinux syslinux-common \
  xorriso mtools dosfstools binutils unzip sassc imagemagick psmisc \
  debian-archive-keyring rsync jq curl wget fakeroot git

Verify dependencies:

The build script itself checks for missing dependencies and tells you what to install — you don't need to check manually beforehand.

Package	Purpose
mmdebstrap	Bootstrap the base Debian chroot
squashfs-tools	Compress the rootfs into a SquashFS image
isolinux / syslinux-common	BIOS boot binaries (isolinux.bin, *.c32 modules) for the ISO -- installed into the profile's own chroot, not the host
xorriso	Create hybrid ISO images (BIOS + UEFI)
mtools	Manipulate FAT filesystems (EFI image inside ISO)
dosfstools	Format FAT partitions (EFI image)
binutils / libisoburn	Linker and ISO manipulation tools
sassc	SCSS compiler for Plymouth themes
imagemagick	Image processing for branding assets
psmisc	Provides fuser to kill leftover processes on port 5900
fakeroot	Build packages without real root privileges
rsync	Sync the base chroot into the working target
jq / curl / wget / unzip / git	Download and extract resources during build

Profiles 📌

A profile lives under profiles/<name>/ and provides:

• profile.conf — display name, package-name slug, ISO volume label/filename prefix, Plymouth theme name, boot-icons source
• packages.list — the mmdebstrap bootstrap package list
• repo.sh — defines profile_setup_repo() / profile_teardown_repo(), configuring the profile's own APT repo and keyring inside the chroot
• packages.sh — defines PROFILE_REPO_PACKAGES, PROFILE_COMMON_PACKAGES, PROFILE_BACKPORTS_PACKAGES, PROFILE_LOCAL_PIN_GLOB
• customize.sh — defines profile_customize(), the post-install branding/extra-apps step
• ploader/ — the vendored Ploader EFI binary (ploader_x64.efi) and boot theme (theme/)
• syslinux/ — the BIOS boot menu background (splash.png)
• boot-icons/ — asset files (the profile's APT signing key, if any, is embedded directly in repo.sh instead of a separate file)

profiles/pear/ is the existing Pulsar OS setup. Adding a second, completely different distro is just adding a new profiles/<name>/ directory — the engine in build-iso.sh doesn't change.

Refreshing the chroot quickly 📌

sync-rootfs.sh re-clones build/rootfs-target-<branch> from the already-bootstrapped build/rootfs-base-<branch> and reinstalls the local .deb packages from PKG/debian/build/packages, without redoing the full base bootstrap. Useful while iterating on packages. Accepts --branch|-b <branch> and --nvidia.

Boot Status sequence 📌

Result: booted, installed pearOS and booted it ✅

Success score: 100/100

Test	Score
Boot	100/100
UI sanity	100/100
Installable	100/100
Usability	100/100

Usability checks:

Check	Result
login + desktop	✅
UI sanity (installed)	✅ top 99% / dock 100%
Konsole opens	✅
os-release says pearOS	✅
sudo apt-get dist-upgrade	✅
Pafari opens	✅
Calculator opens	✅
Notes opens	✅
Finder opens	✅
Kate opens	✅

One screenshot every 10s.

1. 10s —
2. 20s —
3. 30s —
4. 40s —
5. 50s —
6. 60s —
7. 70s —
8. 80s —
9. 90s —
10. 100s —
11. 110s — desktop ready, then clicked Install pearOS in Welcome —
12. 120s — pearOS installer loading —
13. 130s — pearOS installer loading —
14. 140s — Language screen, then selected English —
15. 150s — Language screen, then clicked Next —
16. 160s — Recovery screen, then selected Install pearOS Goldwing —
17. 170s — Recovery screen, then clicked Continue —
18. 180s — Installer welcome, then clicked Continue —
19. 190s — Terms and Conditions, then clicked Continue —
20. 200s —
21. 210s —
22. 220s —
23. 230s —
24. 240s —
25. 250s —
26. 260s —
27. 270s — Calamares —
28. 280s — Calamares: Welcome, clicked Next —
29. 290s — Calamares: Location, clicked Next —
30. 300s — Calamares: Keyboard, clicked Next —
31. 310s — Calamares: Partitions, selected Erase disk —
32. 320s — Calamares: Partitions, clicked Next —
33. 330s — Calamares: Summary, clicked Install —
34. 340s — Calamares: installing (2 min) —
35. 350s — Calamares: installing (4 min) —
36. 360s — Calamares: installation finished —
37. 370s — Installed system: first boot —
38. 380s — Installed system: first boot —
39. 390s — Installed system: first boot —
40. 400s — Installed system: first boot —
41. 410s — Installed system: first boot —
42. 420s — Installed system: reached the login screen / desktop —
43. 430s — First boot: country —
44. 440s — First boot: transfer —
45. 450s — First boot: languages —
46. 460s — First boot: accessibility —
47. 470s — First boot: data & privacy —
48. 480s — First boot: PearID —
49. 490s — First boot: create account —
50. 500s — First boot: account filled in —
51. 510s — First boot: terms —
52. 520s — First boot: location services —
53. 530s — First boot: time zone —
54. 540s — First boot: analytics —
55. 550s — First boot: screen time —
56. 560s — First boot: Piri —
57. 570s — First boot: look —
58. 580s — First boot: updates —
59. 590s — First boot: ready —
60. 600s — First boot: applying settings —
61. 610s — Login screen —
62. 620s — Login screen —
63. 630s — Login screen —
64. 640s — Login screen —
65. 650s — Login screen —
66. 660s — Login screen —
67. 670s — Login screen —
68. 680s — Login screen —
69. 690s — Login screen —
70. 700s — Login screen —
71. 710s — Logging in —
72. 720s — Logging in —
73. 730s — Logging in —
74. 740s — Logging in —
75. 750s — Logging in —
76. 760s — Installed system: desktop —
77. 770s — Konsole opened —
78. 780s — Konsole: cat /etc/os-release —
79. 790s — Konsole: apt-get dist-upgrade succeeded —
80. 800s — App: Pafari opened —
81. 810s — App: Calculator opened —
82. 820s — App: Notes opened —
83. 830s — App: Finder opened —
84. 840s — App: Kate opened —

UI Sanity Test 📌

Result: menu bar + dock look as expected ✅
Compared against the reference tests/ui-reference/debian/desktop.png (% of pixels within ±16 per channel; pass ≥ 90%).

Area	Similarity
Top bar (first 30 px)	96.8%
Dock (last 100 px)	100.0%

Current frame:

Star History

Copyright and Licensing 📌

This project is released under the GNU Pubilc License v3 or later

Copyright: Alexandru Balan @ Pear Software and Services S.R.L. based in Romania, Dacia Boulevard 133, floor D, Sector 2, Bucharest C.I.F.: 50888207

Raspberry Pi (arm64)

Latest boot / first-boot / usability test sequence: seq-pi/README.md