QEMU Virtual Machine
QEMU provides an excellent development and testing environment for Avocado OS without requiring physical hardware.
Supported Architectures
- ARM64 - Primary development target
- x86_64 - Development and CI/CD testing
Use Cases
- Development - Code without physical hardware
- CI/CD - Automated testing pipelines
- Demos - Presentations and evaluations
- Training - Learning Peridio concepts
Features
- Full Avocado OS compatibility
- OTA update simulation
- Network connectivity
- Remote access capabilities
- Container support
Limitations
- No hardware-specific features (GPIO, etc.)
- Performance differs from real hardware
- Some drivers may not be available
- WireGuard tunnels require Linux host
Getting Started
Get up and running with the Avocado Linux SDK in minutes.
Prerequisites
- A Mac (macOS 10.12+) or Linux (Ubuntu 22.04+, Fedora 39+) development machine
- Docker installed
- 3GB+ available disk space
Provisioning your device
- Initialize your project
avocado init --target qemux86-64 avocado-qemu
cd avocado-qemu
- Install all components (SDK, extensions, and runtime dependencies):
avocado install -f
- Build all components
avocado build
- Provision a runtime
avocado provision -r dev
- Run virtual target
avocado sdk run -ie vm dev
You may log in using the username root, and will not be prompted for a password.