> For the complete documentation index, see [llms.txt](https://redcloud-os.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://redcloud-os.gitbook.io/docs/getting-started/intro.md).

# Welcome

## Introduction

<figure><img src="/files/4iuMNBzMOuJl0SEWWWoR" alt=""><figcaption></figcaption></figure>

RedCloud OS is a Debian-based Multicloud Adversary Simulation Operating System engineered for conducting red team operations across cloud-native platforms.

### Overview

RedCloud OS is a specialized Linux distribution built for security professionals who need a reliable platform for:

* Cloud security assessments (AWS, Azure, GCP)
* Kubernetes and container security
* DevOps security testing
* Security research across cloud-native platforms

#### Key Features

**Security-First Design**\
Purpose-built for cloud security professionals, red teams, and penetration testers conducting assessments in AWS, Azure, GCP, and hybrid environments.

**Production Ready**\
Built on Debian 13 (Trixie) with KDE Plasma desktop. Professional-grade stability with enterprise-level reliability.

**Live or Persistent**\
Boot from USB for ephemeral security assessments, or install permanently with Calamares installer for your daily security workstation.

**Tool Management Made Easy**\
Update, install, and remove security tools independently using the built-in redcloud profile manager. No ISO rebuilds required.

**Cloud & Hybrid Ready**\
Pre-configured for multicloud security assessments with open-source security toolkits.

### Why RedCloud OS?

RedCloud OS separates **platform stability** from **tool velocity**. The base ISO provides a rock-solid Debian foundation with KDE Plasma, while security tools are installed post-boot through profiles. This architecture allows you to:

* **Stay Updated**: Update security tools without rebuilding the entire ISO
* **Choose Your Weapons**: Install only the profiles you need for your engagements
* **Professional Environment**: Clean, branded KDE Plasma interface for serious security work
* **Enterprise Ready**: Based on Debian's legendary stability and security track record

### What's Inside

#### Base Platform (Included in ISO)

* **OS**: Debian 13 (Trixie) with Linux kernel 6.12+
* **Desktop**: KDE Plasma
* **Installer**: Calamares for easy permanent installation
* **Profile Manager**: `redcloud` command-line tool for managing security tools

### Quick Start

```bash
# Boot from USB or VM
# Login credentials (live session):
# Username: redcloud
# Password: redcloud

# Install/Update tools
redcloud -u
or 
redcloud --update
```

### System Requirements

#### Running RedCloud OS

* **CPU**: Atleast 2 Cores, 4+ Cores recommended
* **RAM**: 4GB minimum, 8GB+ recommended
* **Storage**: 20GB+ for installation (live boot: none required)
* **Architecture**: amd64 (arm currently under development)

#### Supported Boot Modes

* UEFI (Secure Boot must be disabled)
* Virtual Machines (VMware, VirtualBox, KVM/QEMU)
* Bare Metal (Expremental)
* USB Boot (live persistence optional)

### Use Cases

#### Multicloud Adversary Simulation

Assess security posture of AWS, Azure, and GCP environments with specialized tools for IAM analysis, privilege escalation detection, and cloud-native exploitation.

#### Red Team Operations

Conduct adversary simulations in cloud and hybrid enterprise environments with tools organized by attack lifecycle phases.

#### Security Research

Study cloud IAM abuse, container escape techniques, Kubernetes security, and hybrid identity attack paths in a dedicated research environment.

#### Training & Education

Teach cloud security concepts and attacks with a consistent, reproducible platform that students can install or run live using Build & Break.

### Key Features

#### Enterprise Stability

Based on Debian 13 (Trixie):

* APT package management
* Systemd init system
* Regular security updates
* LTS kernel support
* Professional-grade reliability

#### Tool Organization

Security tools categorized by use case:

* Cloud security (AWS, Azure, GCP, Multicloud)
* Kubernetes & Container Security
* DevOps
* OSINT
* Build & Break (Build your own vulnerable labs & conduct security assesments)

#### Documentation

Comprehensive documentation covering:

* Installation guides (live boot, USB, permanent)
* Profile management
* Tool usage examples
* Troubleshooting common issues
* FAQ and best practices

### Default Credentials

#### Live Session

* **Username**: `redcloud`
* **Password**: `redcloud`
* **Sudo**: Enabled without password prompt

::: warning Security Notice The live session is designed for ephemeral security assessments. Do not use for sensitive operations. For a secure environment, install permanently and create your own user credentials via Calamares installer. :::

### Community & Support

RedCloud OS is developed by **CWLabs Pvt Ltd** as a specialized security platform for cloud-native environment assessments.

### Get RedCloud OS

Ready to start? Head to the Getting Started guide to download RedCloud OS and create your first bootable USB.

### Jump right in