Skip to content

jegly/oneclick-ubuntu-vm-sandbox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Ubuntu Sandbox VM - One-Click Launcher

πŸš€ Automatically downloads, verifies, and launches Ubuntu 24.04 Desktop in a disposable QEMU virtual machine with zero configuration.

✨ Features

  • βœ… Automatic ISO management - Downloads and caches Ubuntu 24.04 Desktop ISO
  • βœ… Cryptographic verification - SHA256 checksum validation against official Ubuntu sources
  • βœ… Hardware acceleration - Automatic KVM detection and usage
  • βœ… Temporary disk - 32GB qcow2 image auto-deleted on exit (no traces left)
  • βœ… Smart resource allocation - Detects and allocates optimal CPU/RAM (50% of host, max 8GB)
  • βœ… Resume support - Interrupted downloads can be resumed
  • βœ… Network ready - VM has internet access via user-mode networking
  • βœ… True disposable - Every launch is a fresh environment

πŸ”’ Security Note

This provides good isolation for testing and quick Dev experimentation, but is not a maximum-security sandbox. The VM has network access and shares the display server. Suitable for testing unknown software and preventing accidental host damage, but not recommended for analyzing malicious code.

πŸ“¦ Installation

Method 1: .deb Package (Recommended)

# Download the package
wget https://github.com/globalcve/oneclick-ubuntu-vm-sandbox/releases/download/1.00/sandbox-vm_1.0.deb

# Install it
sudo dpkg -i sandbox-vm_1.0.deb

# Fix dependencies if needed
sudo apt install -f

Method 2: Direct Script

# Download the script
wget https://raw.githubusercontent.com/globalcve/oneclick-ubuntu-vm-sandbox/main/sandbox.sh

# Make it executable
chmod +x sandbox.sh

# Move to PATH (optional)
sudo mv sandbox.sh /usr/local/bin/sandbox

πŸš€ Usage

Simply run:

sandbox

On first run, it will:

  1. Download Ubuntu 24.04 Desktop ISO (~6GB)
  2. Verify cryptographic checksums
  3. Cache the ISO for future use
  4. Launch the VM

Subsequent runs use the cached ISO and launch instantly.

πŸ’» System Requirements

  • OS: Ubuntu/Debian-based Linux distribution
  • RAM: 4GB+ recommended (VM uses 50% of host RAM, max 8GB)
  • Disk: 6GB free space for ISO cache
  • CPU: Multi-core recommended (VM uses up to 4 cores)
  • Optional: /dev/kvm for hardware acceleration (10x faster)

πŸ“¦ Dependencies

The following packages are required (auto-installed with .deb):

  • qemu-system-x86 - QEMU x86 system emulator
  • qemu-utils - QEMU disk image utilities
  • curl - Download tool
  • coreutils - SHA256 checksums

🎯 Use Cases

Made with ❀️ by JEGLY for safe experimentation

About

Automatically downloads, verifies, and launches Ubuntu 24.04 Desktop in a disposable QEMU VM.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages