CISS.debian.installer/lib/cdi_0000_preliminary/README.md

Table of Contents

• 1. CISS.debian.installer
• 2. Preliminary Components – cdi_0000_preliminary
• 2.1. Purpose and Functionality
• 2.2. Requirements
• 2.3. Dependencies
• 2.4. License
• 2.5. Author

1. CISS.debian.installer

Centurion Intelligence Consulting Agency Information Security Standard
The CISS Debian Installer provides a fully automated and hardened installation process.
Master Version: 8.00
Build: V8.00.000.2025.06.17

2. Preliminary Components – cdi_0000_preliminary

This directory contains foundational wrapper scripts for the CISS.debian.installer framework. These scripts serve as minimal but essential building blocks to ensure consistent versioning, usage helps output, and contact information across the entire installer suite.

2.1. Purpose and Functionality

The scripts in this module fulfill the following roles:

• 0001_contact.sh:
  Displays project-related contact details, including PGP fingerprint, security email, and project links. This is shown during installer execution or upon request via CLI.

• 0002_usage.sh:
  Provides a user-facing, color-coded help dialog. It details available command-line options such as debugging modes (--debug), logging configuration, and non-interactive autoinstallation. It also enforces preconditions such as root privileges, and the presence of YAML configuration files.

• 0003_version.sh:
  Displays the current project version, latest Git commit, debootstrap version, and host Bash version. This helps contextualize the environment for debugging and auditing.

2.2. Requirements

• Bash version ≥ 5.1
• Proper invocation context (set -Ceuo pipefail enforced)
• Pre-populated configuration files:
  • .preseed/preseed.yaml
  • .preseed/partitioning.yaml
  • Password files for GRUB, LUKS boot, common, and nuke passphrases

These scripts assume they are sourced or executed within a controlled setup shell, with essential global variables (e.g. VAR_VERSION) predeclared.

2.3. Dependencies

• bash built-ins only (no external binaries invoked except git, debootstrap, and uname in 0003_version.sh)
• ANSI color-supporting terminal (via tput cols, echo -e)
• Git repository context for versioning (git log)

2.4. License

This component is dual-licensed under the European Union Public License v1.2 (EUPL-1.2) or the CoreSecret Custom Contributor License Agreement (CCLA-1.0). You may choose either license as per your usage context. Usage is permitted under the condition that no warranty is implied. Use at your own risk.

2.5. Author

Developed and maintained by
Marc S. Weidner
Centurion Intelligence Consulting Agency

---

no tracking | no logging | no advertising | no profiling | no bullshit