gandalf/secubox-deb
0
1
Fork 0
mirror of https://github.com/CyberMind-FR/secubox-deb.git synced 2026-06-28 17:33:39 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
Page: Live USB QEMU
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
2 Live USB QEMU
CyberMind-FR edited this page 2026-05-12 11:22:20 +02:00
Table of Contents

SecuBox Live USB — QEMU

Launch SecuBox in QEMU for testing and development.

Quick Start

# Clone repository
git clone https://github.com/CyberMind-FR/secubox-deb.git
cd secubox-deb

# Download or build image
# Option A: Download release
wget https://github.com/CyberMind-FR/secubox-deb/releases/latest/download/secubox-live-amd64-bookworm.img.gz
gunzip secubox-live-amd64-bookworm.img.gz
mv secubox-live-amd64-bookworm.img output/

# Option B: Build locally
sudo bash image/build-live-usb.sh

# Launch QEMU
bash scripts/run-qemu.sh

Script Options

scripts/run-qemu.sh [OPTIONS] [IMAGE]

Options:
    -m, --memory MB     RAM size (default: 4096)
    -c, --cpus N        Number of CPUs (default: 4)
    -s, --ssh PORT      Host SSH port (default: 2222)
    -w, --https PORT    Host HTTPS port (default: 9443)
    -d, --display TYPE  Display: gtk, sdl, none, vnc
    --no-efi            Use BIOS instead of EFI

Port Forwarding

Service Host Guest
SSH localhost:2222 :22
HTTPS localhost:9443 :443
HTTP localhost:8080 :80

Access SecuBox

Web Dashboard

Open in browser:

https://localhost:9443

Accept the self-signed certificate warning.

SSH Access

ssh -p 2222 root@localhost
# Password: secubox

Serial Console

In QEMU window, the console is available via the display.

Requirements

  • QEMU: apt install qemu-system-x86
  • KVM (recommended): apt install qemu-kvm
  • OVMF (EFI boot): apt install ovmf

Manual QEMU Command

If you prefer manual control:

qemu-system-x86_64 \
    -enable-kvm \
    -m 4096 \
    -cpu host \
    -smp 4 \
    -drive file=output/secubox-live-amd64-bookworm.img,format=raw \
    -bios /usr/share/ovmf/OVMF.fd \
    -vga virtio \
    -display gtk \
    -netdev user,id=net0,hostfwd=tcp::2222-:22,hostfwd=tcp::9443-:443 \
    -device virtio-net-pci,netdev=net0

Troubleshooting

Black Screen / Kiosk Not Loading

The kiosk expects the SecuBox network interface. If you see a black screen:

# SSH into VM
ssh -p 2222 root@localhost

# Restart kiosk (if needed)
systemctl restart secubox-kiosk

No KVM Acceleration

If KVM is not available:

# Check KVM support
ls /dev/kvm

# Enable if needed (may require BIOS settings)
sudo modprobe kvm_intel  # or kvm_amd

Without KVM, use --no-kvm but expect much slower performance.

Port Already in Use

Change ports with script options:

scripts/run-qemu.sh -s 2223 -w 9444

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