Skip to content

Repository files navigation

EnigmarsOS

Privacy first · Secure by default · Ready immediately

EnigmarsOS is a production-minded Linux distribution based on Arch Linux with KDE Plasma 6. It is not a casual remaster: the repository is structured for long-term packaging, branded install media, reproducible ISO builds and a coherent desktop experience.

Stay as close to upstream Arch as reasonably possible. Customize only where it improves UX, security, privacy, performance or branding.

Design principles

  1. Privacy first — no telemetry, no ads, no forced accounts
  2. Secure by default — AppArmor, UFW, LUKS-ready, hardened sysctl
  3. Ready immediately — gaming, development, office, multimedia out of the box
  4. Developer friendly — full toolchains without bootstrap rituals
  5. Gaming ready — Steam/Lutris/Heroic/Proton stack preinstalled
  6. Beautiful minimalism — AMOLED black, cyan & purple accents, consistent branding

Repository layout

EnigmarsOS/
├── archiso/           # mkarchiso profile (airootfs, boot loaders)
├── packages/          # Custom PKGBUILDs (welcome, artwork, settings, …)
├── branding/          # Logos and brand assets
├── wallpapers/        # Desktop wallpapers
├── themes/            # Plasma, Konsole, etc.
├── plymouth/          # Boot splash
├── sddm/              # Display manager theme
├── calamares/         # Installer settings + branding
├── scripts/           # Build, release and developer tooling
├── docs/              # End-user documentation
├── docker/            # Arch container image for ISO builds
├── public/EnigmarsOS.png
├── packages.x86_64    # ISO package list
├── profiledef.sh      # ISO identity
└── README.md

Build the ISO (Docker — recommended)

Requires Docker with privilege support (loop mounts, pacstrap):

# Prepare branding into the archiso profile
./scripts/build/prepare-profile.sh

# Build inside an Arch Linux container
./scripts/build/docker-build-iso.sh

Artifacts land in out/. Equivalent Make target:

make iso-docker

Native Arch host

sudo pacman -S --needed archiso git squashfs-tools dosfstools libisoburn mtools
./scripts/build/prepare-profile.sh
sudo ./scripts/build/build-iso.sh

Sign release artifacts

export ENIGMARSOS_GPG_KEY=YOUR_KEY_ID
./scripts/release/sign-iso.sh out/enigmarsos-*.iso

Custom packages

Package Role
enigmarsos-filesystem os-release, issue, motd
enigmarsos-settings Secure defaults, Plasma skel
enigmarsos-artwork Logos, wallpapers, colors
enigmarsos-welcome Welcome application
enigmarsos-calamares-config Installer branding
enigmarsos-firefox-config Privacy policies + uBlock
enigmarsos-hooks pacman hooks
enigmarsos-keyring Package signing keyring

Live session

Item Value
User live / live
Desktop Plasma 6 (Wayland)
Installer Calamares (sudo calamares)
Branding EnigmarsOS (no visible Arch labels)

Documentation

See docs/ for installation, gaming, development, virtualization, security, recovery, snapshots, updates and troubleshooting.

Contributing

  1. Keep changes modular and documented.
  2. Prefer upstream packages over forks.
  3. Never reintroduce telemetry or insecure defaults.
  4. Preserve branding consistency (logo: public/EnigmarsOS.png).
  5. Run ./scripts/dev/sync-airootfs-check.sh before opening a PR.

License

GPL-3.0-or-later for EnigmarsOS-specific packaging, branding integration and tooling. Upstream components retain their own licenses. Arch Linux is a trademark of Aaron Griffin and Judd Vinet; EnigmarsOS is an independent project and is not affiliated with Arch Linux.

Links

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages