ELMOS Documentation¶
Embedded Linux on MacOS
A complete embedded Linux SDK for native kernel development on macOS.
Features¶
| Feature | Description |
|---|---|
| 🔧 Native Toolchains | Build cross-compilers for ARM64, ARM, RISC-V |
| 🐧 Kernel Automation | Clone, configure, build Linux kernels |
| 🖥️ Interactive TUI | Rich terminal interface |
| 🚀 QEMU Integration | Boot and debug with GDB |
| 📦 Module Development | Cross-compile kernel modules |
Quick Start¶
# Install
brew tap NguyenTrongPhuc552003/elmos
brew install elmos
# Initialize workspace
elmos init
# Build kernel
elmos kernel config defconfig
elmos kernel build
# Run in QEMU
elmos qemu -r
Documentation¶
User Guide¶
For users installing and using ELMOS:
- Installation - Setup prerequisites
- Getting Started - First kernel build
- Kernel Building - Build configurations
- QEMU Integration - Running and debugging
- Troubleshooting - Common issues
Developer Guide¶
For contributors:
- Architecture - System design
- Diagrams - Visual architecture
- Build System - Task automation
- Code Patterns - Go idioms
- Contributing - Guidelines
CLI Overview¶

Support¶
- GitHub Issues - Bug reports
- Discussions - Questions
MIT Licensed. Inspired by Seiya's tutorial.