Use this file to discover all available pages before exploring further.
Azahar is available for Windows, macOS, Linux, and Android. Choose your platform below and follow the instructions to get Azahar installed. All official releases are published on the GitHub Releases page.
Windows
macOS
Linux
Android
Azahar for Windows is available as an installer or as a zip archive. Both options include the same emulator — the installer handles file associations and shortcuts automatically, while the zip lets you run Azahar from any folder without installation.Which build should you use: MSVC or MSYS2?Two compiler variants are published for each release. If you are unsure which to pick, use the MSYS2 build.
azahar-msys2-windows-installer.exe — recommended, runs a setup wizard
azahar-msys2-windows.zip — portable archive, no installation required
3
Install or extract
Installer: run the .exe and follow the on-screen prompts.
Zip archive: extract the contents to a folder of your choice, then run azahar.exe inside.
Windows for ARM is not supported. You must use a 64-bit x86-64 or ARM64 system running Windows 10 or later.
Azahar provides three macOS builds to match different hardware. If you are unsure which Mac you have, use the universal build — it runs on both Apple Silicon and Intel.
Under Assets, download azahar-macos-universal.dmg for the broadest compatibility, or one of the architecture-specific builds if you prefer a smaller download.
3
Open the disk image and install
Double-click the .dmg file to mount it, then drag Azahar into your Applications folder.
4
Allow the app on first launch
macOS may show a security prompt the first time you open Azahar. Go to System Settings → Privacy & Security and click Open Anyway, then confirm in the dialog.
macOS 13.4 (Ventura) or later is required.
The recommended way to install Azahar on Linux is through Flatpak on Flathub. Flatpak handles dependencies automatically and keeps Azahar up to date through your software center.Option 1: Flatpak (recommended)
1
Install Flatpak
If Flatpak is not already installed, follow the setup guide for your distribution at flatpak.org/setup.
2
Install Azahar from Flathub
Run the following command in your terminal:
flatpak install flathub org.azahar_emu.Azahar
Alternatively, click Install on the Flathub listing if your system supports it.
3
Launch Azahar
Open Azahar from your application launcher, or run:
flatpak run org.azahar_emu.Azahar
Option 2: AppImageAppImages are available on the Releases page for users who prefer a self-contained executable. Two variants are offered:
File
When to use
azahar.AppImage
Default — recommended for most users
azahar-wayland.AppImage
Only if you run a system with no Xwayland support
Native Wayland support has known upstream issues that may cause problems when running the emulator. Use azahar.AppImage unless you specifically require native Wayland.
To run the AppImage, mark it executable and launch it:
chmod +x azahar.AppImage./azahar.AppImage
The Flatpak build also has native Wayland disabled by default. If you need to enable it, use Flatseal to grant the wayland socket permission.
Azahar for Android comes in two variants: the Google Play build and the Vanilla build.
Variant
Where to get it
Notes
Google Play
Play Store
Easiest to install; recommended for most users
Vanilla
Obtainium or direct APK
Faster file management; not permitted on Play Store
Option 1: Google Play (recommended)Install Azahar directly from the Google Play Store. This is the simplest option and supports automatic updates.Option 2: Vanilla build via ObtainiumObtainium lets you install and automatically update the Vanilla variant directly from GitHub. This variant uses an alternative file management method that is faster than the Play Store build.
1
Install Obtainium
Download app-release.apk from the Obtainium Releases page and install it on your device. You may need to allow installation from unknown sources in your Android settings.
2
Add Azahar as an app source
Open Obtainium and tap Add App.
3
Enter the GitHub repository URL
In the App Source URL field, type:
https://github.com/azahar-emu/azahar
Then tap Add.
4
Install the app
Tap Install. When prompted, select your preferred variant (choose Vanilla for the faster file management experience).
Option 3: Direct APK downloadYou can download the latest APK directly from the Releases page and install it manually.
Direct APK installs do not receive automatic updates. You will need to revisit the Releases page and reinstall manually each time a new version is published.
Android 10.0 (64-bit) or later is required. A Snapdragon 835 SoC or better is recommended for good performance.
