---
gitea: none
include_toc: true
---

# 1. CISS.debian.installer

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

# 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](https://coresecret.eu/)**
<!-- vim: set number et ts=2 sw=2 sts=2 ai tw=128 ft=markdown -->
