Language: 中文 | English

DragonOS Playground - One-click tool to launch DragonOS operating system

This project provides a simple and easy way to quickly launch and experience the DragonOS operating system. By automatically downloading the latest DragonOS artifacts through scripts and launching the system using QEMU virtual machine, users can start using DragonOS without complex configuration.

🌟 Special recommendation for cloud-native development experience! On the cnb.cool platform, you can start DragonOS with zero configuration and one click, enjoying the convenience of cloud development.

🆕 Daily update experience! This project automatically performs nightly builds every night, ensuring you can experience the latest development version of DragonOS, including the latest features, performance optimizations, and bug fixes.

🌟 One-click launch! DragonOS Community Repository: https://github.com/DragonOS-Community/DragonOS

• ☁️ 🌟 Cloud-Native First - Zero configuration, one-click experience on cnb.cool platform
• 🆕 Daily Builds - Nightly build ensures experience of the latest development version
• 🚀 One-Click Launch - Run a single command to start a complete DragonOS system
• 📦 Auto Download - Intelligently detects and automatically downloads the latest DragonOS artifacts
• 🌐 Cloud Development - Access anytime, anywhere without consuming local resources

Experiencing DragonOS on the cnb.cool cloud-native development platform is the simplest and fastest way, requiring no local installation of any dependencies!

1. Access DragonOS Playground

   • Open browser and visit: https://cnb.cool/DragonOS-Community/playground
   • Fork the current project
   • Click the "Cloud-Native Development" button
   • The project will load automatically without additional import steps

2. One-Click Launch

   ./run.sh --clean
   ./run.sh
   

3. Exit System

   • Press Ctrl+X key combination to exit QEMU

Why recommend cloud-native development?

• ✅ Zero Configuration - No need to install QEMU, Docker, or other dependencies
• ✅ Instant Experience - Run DragonOS within seconds
• ✅ Cloud Environment - Access anytime, anywhere without consuming local resources
• ✅ Auto Update - Daily nightly build, always using the latest development version

If you want to run in a local environment, please follow these steps:

1. Clone Project

   • Clone the project locally:

   git clone https://cnb.cool/DragonOS-Community/playground
   cd playground
   

2. Launch System

   ./run.sh --clean
   ./run.sh
   

   The script will automatically:

   • Check if DragonOS artifacts exist locally
   • If they don't exist, automatically download the latest artifacts
   • Launch QEMU virtual machine to run DragonOS

• Linux Operating System
• Bash shell environment
• Sufficient disk space (for downloading artifacts)

• Docker - For downloading artifacts and running DragonOS

• Automatically detects and downloads DragonOS artifacts
• Launches QEMU virtual machine
• Supports colored output and error handling
• Supports cleanup options for easy updating to the latest version
  • ./run.sh --clean - Clean local artifact files and exit
  • ./run.sh --help - Display help information
  • After cleanup, running ./run.sh again will automatically download the latest version

• Pulls latest nightly build artifacts from Docker images
• Automatically extracts and verifies file integrity
• Supports force re-download option
• Automatically gets the latest development version every day

• Configures QEMU virtual machine parameters
• Supports multiple architectures and boot modes
• Provides network and device configuration

export DRAGONOS_LOGLEVEL=4  # Only show WARN and above level logs
# Log levels: 0=EMERG, 1=ALERT, 2=CRIT, 3=ERR, 4=WARN, 5=NOTICE, 6=INFO, 7=DEBUG

.
├── run.sh                    # Main launch script
├── scripts/                  # Scripts directory
│   ├── download.sh          # Artifact download script
│   └── run-qemu.sh          # QEMU launch script
├── bin/                     # Artifacts directory (generated during runtime)
│   ├── kernel/              # Kernel files
│   │   └── kernel.elf
│   ├── disk-image-x86_64.img # Disk image
│   └── ...                  # Other architecture files
├── serial_opt.txt           # Serial output log
└── README_EN.md            # This document

A: Check if Docker is running properly and if network connection is normal:

docker --version
docker pull docker.cnb.cool/dragonos-community/playground/artifacts:nightly-latest

You can directly modify the QEMU configuration parameters in the scripts/run-qemu.sh file, including:

• Memory size: QEMU_MEMORY
• CPU cores: QEMU_SMP
• Network configuration: QEMU_DEVICES

• Project Homepage: https://cnb.cool/DragonOS-Community/playground
• Issue Reporting: Please submit Issues on the project page
• Community Discussion: DragonOS Community

This project is released under GPLv2.

---

What is Nightly Build?

• Latest development version automatically built every night
• Contains the latest features, performance optimizations, and bug fixes
• Lets you experience the latest progress of DragonOS at the first opportunity

Update Time:

• 🕙 Build Time: Automatically performed every night (Beijing Time 01:00)
• 🔄 Update Frequency: Daily updates
• 📦 Artifact Version: Uses nightly-latest tag

Notes:

• ⚠️ Nightly build is a development version and may contain unstable features
• 🔧 Suitable for developers, testers, and users who want to experience the latest features
• 📋 For stable versions, please check official DragonOS releases

---

🎉 Start your DragonOS exploration journey now!