gandalf/secubox-deb
0
1
Fork 0
mirror of https://github.com/CyberMind-FR/secubox-deb.git synced 2026-06-29 01:59:26 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
Page: Live USB VirtualBox
Pages
API Reference DE API Reference FR API Reference ZH API Reference ARM Installation DE ARM Installation FR ARM Installation ZH ARM Installation Acknowledgments Android ToolBox Anti Track Architecture Browser Extension CATEGORIES DE CATEGORIES EN CATEGORIES FR CATEGORIES ZH CTL Grammar Configuration DE Configuration FR Configuration ZH Configuration Device Categories ESPRESSObin DE ESPRESSObin FR ESPRESSObin ZH ESPRESSObin Eye Remote FAQ Troubleshooting Financing Model Fiscal Notes Hardware Matrix Home DE Home FR Home ZH Home Installation DE Installation FR Installation ZH Installation Live USB DE Live USB FR Live USB QEMU Live USB VirtualBox Live USB ZH Live USB MODULES DE MODULES EN MODULES FR MODULES ZH Multi Agent Worktree Multiboot QEMU ARM64 Roadmap Smart Strip Sponsor a Port Support ThreatMesh FR ThreatMesh Troubleshooting DE Troubleshooting FR Troubleshooting ZH Troubleshooting UI COMPARISON VirtualBox Setup
3 Live USB VirtualBox
CyberMind-FR edited this page 2026-05-12 11:22:20 +02:00
Table of Contents

Live USB to VirtualBox — Quick Start Guide

Test SecuBox on VirtualBox in minutes using the pre-built live image.

Prerequisites

  • VirtualBox 7.0+ installed
  • 8GB free disk space
  • 4GB RAM available

Quick Start (One-Liner)

# Download and create VM in one command
curl -sL https://github.com/CyberMind-FR/secubox-deb/releases/latest/download/secubox-live-amd64-bookworm.img.gz | \
  gunzip > secubox-live.img && \
  VBoxManage convertfromraw secubox-live.img secubox-live.vdi --format VDI && \
  bash <(curl -sL https://raw.githubusercontent.com/CyberMind-FR/secubox-deb/master/image/create-vbox-vm.sh) secubox-live.vdi

Step-by-Step Guide

1. Download the Live Image

# From GitHub Releases
wget https://github.com/CyberMind-FR/secubox-deb/releases/latest/download/secubox-live-amd64-bookworm.img.gz

# Extract
gunzip secubox-live-amd64-bookworm.img.gz

2. Convert IMG to VDI

VirtualBox requires VDI format:

VBoxManage convertfromraw secubox-live-amd64-bookworm.img secubox-live.vdi --format VDI

3. Create the VM

Option A: Using the Script

# Download and run the VM creation script
curl -sLO https://raw.githubusercontent.com/CyberMind-FR/secubox-deb/master/image/create-vbox-vm.sh
chmod +x create-secubox-vm.sh
./create-secubox-vm.sh secubox-live.vdi

Option B: Manual Commands

VM_NAME="SecuBox-Live"
VDI_PATH="$(pwd)/secubox-live.vdi"

# Create VM
VBoxManage createvm --name "$VM_NAME" --ostype "Debian_64" --register

# Configure VM
VBoxManage modifyvm "$VM_NAME" \
    --memory 4096 \
    --cpus 2 \
    --vram 128 \
    --graphicscontroller vboxsvga \
    --firmware efi \
    --boot1 disk \
    --nic1 nat \
    --natpf1 "SSH,tcp,,2222,,22" \
    --natpf1 "HTTPS,tcp,,9443,,443"

# Add storage
VBoxManage storagectl "$VM_NAME" --name "SATA" --add sata --controller IntelAhci
VBoxManage storageattach "$VM_NAME" --storagectl "SATA" --port 0 --device 0 --type hdd --medium "$VDI_PATH"

4. Start the VM

# GUI mode
VBoxManage startvm "SecuBox-Live" --type gui

# Headless mode (background)
VBoxManage startvm "SecuBox-Live" --type headless

5. Access SecuBox

Wait 30-60 seconds for boot, then:

Access Command/URL
SSH ssh -p 2222 root@localhost
Web UI https://localhost:9443
Password secubox

Complete Script

Save as secubox-vbox-quickstart.sh:

#!/bin/bash
# SecuBox VirtualBox Quick Start
# Usage: ./secubox-vbox-quickstart.sh [image.img]

set -euo pipefail

IMG="${1:-secubox-live-amd64-bookworm.img}"
VDI="${IMG%.img}.vdi"
VM_NAME="SecuBox-Live-$(date +%Y%m%d)"

# Check if image exists
if [[ ! -f "$IMG" ]]; then
    echo "Downloading SecuBox Live image..."
    wget -q --show-progress \
        https://github.com/CyberMind-FR/secubox-deb/releases/latest/download/secubox-live-amd64-bookworm.img.gz
    gunzip secubox-live-amd64-bookworm.img.gz
    IMG="secubox-live-amd64-bookworm.img"
    VDI="${IMG%.img}.vdi"
fi

# Convert to VDI if needed
if [[ ! -f "$VDI" ]]; then
    echo "Converting to VDI format..."
    VBoxManage convertfromraw "$IMG" "$VDI" --format VDI
fi

# Remove existing VM
VBoxManage unregistervm "$VM_NAME" --delete 2>/dev/null || true

# Create VM
echo "Creating VM: $VM_NAME"
VBoxManage createvm --name "$VM_NAME" --ostype "Debian_64" --register

# Configure
VBoxManage modifyvm "$VM_NAME" \
    --memory 4096 \
    --cpus 2 \
    --vram 128 \
    --graphicscontroller vboxsvga \
    --firmware efi \
    --boot1 disk \
    --nic1 nat \
    --natpf1 "SSH,tcp,,2222,,22" \
    --natpf1 "HTTPS,tcp,,9443,,443" \
    --clipboard bidirectional

# Storage
VBoxManage storagectl "$VM_NAME" --name "SATA" --add sata --controller IntelAhci
VBoxManage storageattach "$VM_NAME" --storagectl "SATA" --port 0 --device 0 \
    --type hdd --medium "$(realpath "$VDI")"

# Start
echo "Starting VM..."
VBoxManage startvm "$VM_NAME" --type gui

echo ""
echo "=== SecuBox VM Ready ==="
echo "SSH:   ssh -p 2222 root@localhost"
echo "Web:   https://localhost:9443"
echo "Pass:  secubox"
echo ""
echo "Wait 30-60 seconds for boot to complete."

Troubleshooting

API errors / "Invalid credentials" (v2.1.1 Fix)

If you see API 502 errors or "Invalid credentials" after login, upgrade Python packages:

ssh -p 2222 root@localhost
pip3 install --break-system-packages 'pydantic>=2.0' 'fastapi>=0.100' 'uvicorn>=0.25'
systemctl restart secubox-hub secubox-auth secubox-system

This issue is fixed in v2.1.1+ images.

VM won't boot (black screen)

# Try BIOS instead of EFI
VBoxManage modifyvm "SecuBox-Live" --firmware bios

Port already in use

# Use different ports
VBoxManage modifyvm "SecuBox-Live" --natpf1 delete "SSH"
VBoxManage modifyvm "SecuBox-Live" --natpf1 delete "HTTPS"
VBoxManage modifyvm "SecuBox-Live" --natpf1 "SSH,tcp,,2223,,22"
VBoxManage modifyvm "SecuBox-Live" --natpf1 "HTTPS,tcp,,9444,,443"

Graphics issues

# Disable 3D acceleration
VBoxManage modifyvm "SecuBox-Live" --accelerate3d off --graphicscontroller vmsvga

Check VM status

VBoxManage list runningvms
VBoxManage showvminfo "SecuBox-Live" | head -40

Cleanup

# Stop VM
VBoxManage controlvm "SecuBox-Live" poweroff

# Delete VM and files
VBoxManage unregistervm "SecuBox-Live" --delete

# Remove VDI
rm -f secubox-live.vdi

See Also

SecuBox | FR | DE | 中文 | v2.2.4-pre1

Projet

Soutenir

🔴 BOOT — Démarrer

🟢 ROOT — Configuration

🟣 MIND — Modules

🔵 MESH — Référence

🟠 WALL — Matériel

🤖 Workflow Agents

Liens

SecuBox-Deb · Licence : CMSD-1.0 (Source-Disclosed) Contact : CyberMind · Gérald Kerma · Notre-Dame-du-Cruet, Savoie Hardware-Matrix · Acknowledgments · Wiki v2.5.0