Files
imager/README.md

3.8 KiB
Raw Blame History

Armbian logo

Purpose of This Repository

Armbian Imager is the official tool for downloading and flashing Armbian OS images to single-board computers. It focuses on safe and reliable flashing of Armbian images, with board-aware guidance and verification.

Key features

  • Support for 300+ boards with smart filtering and board-aware metadata
  • Disk safety checks, checksum validation, and post-write verification
  • Native cross-platform builds for Linux, Windows, and macOS (x64 and ARM64)
  • Multi-language UI with automatic system language detection
  • Automatic application updates
  • Small binary size and minimal runtime dependencies

Armbian Imager

Testimonials

“A proper multi-platform desktop app that actually works, which is rarer than youd think.” — Bruno Verachten, Senior Developer Relations Engineer (source)

"The Upcoming Armbian Imager Tool is a Godsend for Non-Raspberry Pi SBC Owners" — Sourav Rudra, It's FOSS (source)

"According to Armbian, this results in less RAM and storage usage and a faster experience." — Jordan Gloor, HowtoGeek.com (source)

Download

Prebuilt binaries are available for all supported platforms.


macOS

Windows

Linux
Intel & Apple Silicon x64 & ARM64 x64 & ARM64
.dmg / .app.zip .exe / .msi .deb / .AppImage

How It Works

  1. Select Manufacturer — Choose from 70+ supported SBC manufacturers or load a custom image
  2. Select Board — Pick your board using real photos and metadata from armbian.com
  3. Select Image — Choose desktop or server, kernel variant, and stable or nightly builds
  4. Flash — Download, decompress, write, and verify automatically

Customization

  • Theme Selection: Light, dark, or automatic based on system preferences
  • Developer Mode: Enable detailed logging and view application logs
  • Language Selection: 17 languages with automatic system detection

Platform Support

Platform Architecture Notes
macOS Intel x64 Full support
macOS Apple Silicon Native ARM64 build, Touch ID support
Windows x64 Requires Administrator privileges
Windows ARM64 Native ARM64 build, requires Administrator privileges
Linux x64 Uses UDisks2 and pkexec for elevated privileges
Linux ARM64 Native ARM64 build

Supported Languages

English, Italian, German, French, Spanish, Portuguese, Dutch, Polish, Russian, Chinese, Japanese, Korean, Ukrainian, Turkish, Slovenian, Swedish, Croatian

Development

Development setup, build instructions, and project structure are documented in DEVELOPMENT.md.


Made with ❤️ by the Armbian community