SCPSEC OS Builder

An automated live-build environment for SCPSEC OS 1.0 — a secure, Debian-based operating system featuring a customized GNOME desktop, integrated dark theme, hardened security defaults, and the Calamares graphical installer.

📌 System Requirements

Before starting the build process, ensure your host environment meets the following minimum specifications:

Resource	Requirement
Host OS	Debian 12 (Bookworm) or Ubuntu 22.04+ (64-bit)
CPU Architecture	x86_64 / amd64
RAM	4 GB minimum (8 GB recommended)
Disk Space	15 GB free space
Privileges	Root / Sudo access
Network	Active internet connection

🚀 Quick Start

1. Clone the Repository

git clone https://github.com/scpsec/scpsec-os-builder.git
cd scpsec-os-builder

2. Make Scripts Executable

chmod +x install-deps.sh build.sh

3. Run Pre-Flight Check & Install Dependencies

The install-deps.sh script verifies available disk space, RAM, network connectivity, and installs all required host packages (live-build, xorriso, debootstrap, and more).

sudo ./install-deps.sh

4. Build the ISO Image

Run the build script to configure the root filesystem, apply SCPSEC OS branding, install required packages, and generate the final bootable ISO image.

sudo ./build.sh

Upon successful completion, the live hybrid ISO will be generated inside the build directory:

scpsec-os/live-image-amd64.hybrid.iso

🛠️ System Overview

Base Distribution: Debian 12 (Bookworm)
Desktop Environment: GNOME (Optimized)
Security Focus: Hardened Debian configuration
System Theme: SCPSEC Dark Theme
Icon Theme: Numix Circle
System Installer: Calamares
Boot Splash: SCPSEC Plymouth Theme
Target Hardware: UEFI & Legacy BIOS (x86_64)

📂 Repository Structure

scpsec-os-builder/
├── install-deps.sh   # Dependency installer & pre-flight checker
├── build.sh          # Main live-build automation script
├── README.md         # Project documentation
└── LICENSE           # License

🔗 Official Links

Website: https://scpsec.cc
GitHub Organization: https://github.com/scpsec
SourceForge: https://sourceforge.net/projects/scpsec-os/

📄 License

This project is released under the MIT License.

Copyright (c) 2026 scpsec

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

SCPSEC OS

SCPSEC OS is a secure, lightweight, Debian-based Linux distribution custom-designed for cybersecurity auditing, secure operations, and privacy-focused computing environments.

💻 Overview & Key Features

Debian 12 Core: Built on top of Debian 12 (Bookworm) stable release for high system reliability and package security.
Customized Desktop: Integrated GNOME workspace configured with custom SCPSEC dark themes and Numix Circle icon branding.
Calamares Installer: Easy-to-use graphical system installer for smooth disk partitioning and dual-boot installations.
UEFI & Legacy Support: Out-of-the-box compatibility for modern UEFI hardware as well as legacy BIOS systems.
Hardened Security Defaults: Configured out of the box with restricted system policies and enhanced network isolation options.