> For the complete documentation index, see [llms.txt](https://digicorplabs.gitbook.io/digithree-labs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://digicorplabs.gitbook.io/digithree-labs/documentation/dgmv-ict-blackbox/dgmv-ict-blackbox-os-manual.md).

# DGMV ICT BlackBox OS Manual

## Image Details

An up-to-date version of the operating system installation image is provided by DigiCorp Labs. 

The image can be delivered in two formats, one for cloud environments and one for on-premise.

**Cloud Environments**: A QCOW2-formatted image designed for seamless integration with various cloud platforms.​

**On-Premise Installations**: An ISO image intended for direct installation on physical hardware via bootable media, provided with an installer.

<table><thead><tr><th width="155.90234375">Cloud Provider</th><th width="144.53125">QCOW2 Support</th><th>Notes</th></tr></thead><tbody><tr><td>AWS</td><td>✓ Yes</td><td>Supports importing QCOW2 images; conversion may be required.</td></tr><tr><td>GCP</td><td>✓ Yes</td><td>Allows image import; conversion to native format may be necessary.</td></tr><tr><td>Hetzner</td><td>✓ Yes</td><td>Supports QCOW2 images; ensure compatibility with their platform.</td></tr><tr><td>OpenStack</td><td>✓ Yes</td><td>Natively supports QCOW2 format.</td></tr><tr><td>Equinix Metal</td><td>✓ Yes</td><td>Supports custom OS images, including QCOW2.</td></tr><tr><td>Scaleway</td><td>✓ Yes</td><td>Allows custom QCOW2 image uploads.</td></tr><tr><td>Vultr</td><td>✓ Yes</td><td>Supports uploading QCOW2 images for custom deployments.</td></tr><tr><td>DigitalOcean</td><td>✓ Yes</td><td>Allows custom image uploads; QCOW2 support may require conversion.</td></tr><tr><td>VMware</td><td>✓ Yes</td><td>Supports QCOW2 images; may require conversion to VMDK format.</td></tr></tbody></table>

Note: Some providers may require conversion of QCOW2 images to their native formats. For instance, AWS and GCP may necessitate image translation during the upload process.

## On-Premise Image Deployment

For on-premise installations, the provided ISO image can be flashed onto a USB drive using tools like dd (Linux/macOS) or Rufus (Windows). Booting from this USB initiates the installation process, guiding users through system setup. The installer will take care of the disk partitioning, installation, etc.

**Image Specifications**

* **Cloud Image (QCOW2):**
  * File Size: Approximately 1.2 GB​
  * Version: v1.0.1 \[17] (Released: 26th, March 2025)​
  * Checksum: SHA-256: `82d42649525838e373d031619614718b3a617b187c8e57ed48b1d44514ac6e8a`
  * Comments: Uploaded to DigitalOcean
* **On-Premise Image (ISO):**
  * File Size: Approximately 2.0 GB
  * Version: v1.0.0 (Released: March 2025)​
  * Checksum: SHA-256: DBD

Images can be found in the DGMV Distribution Portal: <https://downloads.dgmv.id>

Corresponding credentials are handed over to you by DigiCorp Labs.

## System Requirements

For optimal performance, ensure the target system meets the following specifications:​

* **Evaluation Setup:**
  * RAM: 8 GB​
  * Storage: 20 GB
  * CPU: Dual-core processor​
  * Network: 100 Mbps uplink
* **Production Setup**:
  * RAM: 16 - 64 GB​
  * Storage: 1 TB+ SSD​ (ideally RAID 10)
  * CPU: Quad-core or higher, with support for virtualization extensions​
  * Network: 1 Gbps uplink​
  * Additional Requirements:
    * **TPM (Trusted Platform Module)**: Version 2.0 for enhanced security features
    * **UEFI Firmware**: For modern boot processes

## Configuration

### Network Configuration

Upon boot, the system utilizes DHCP to obtain network configurations. In cloud environments, cloud-init fetches metadata from the provider to apply specific network settings. This process ensures that the instance is configured according to the cloud provider's specifications, as each VM in a cloud provider has distinct network configuration). This automatic retrieval of network parameters simplifies the installation by a lot.<br>

\ <br>