\n $\"GitHub$ \n $\"GitHub$ \n $\"Build$ \n \n

\n\n\nThis repository provides ARM64-optimized container images built from the original **[FEX-Emu project](https://github.com/FEX-Emu/FEX)**. These images enable running x86 and x86_64 applications on ARM64 platforms through FEX's high-performance emulation.\n\n## 🐳 Docker Images\n\nContainer images are hosted on \n\n| Host | URL |\n| :------------------ | :--------------------------------------- |\n| DockerHub | **[supersunho/fex-emu](https://hub.docker.com/r/supersunho/fex-emu)** |\n| Github | **[supersunho/docker-fex-emu](https://github.com/supersunho/docker-fex-emu)** |\n\n## 🚀 Quick Start\n\n### Pull and Run\n\n```bash\n# Pull the latest Ubuntu 24.04 image\ndocker pull supersunho/fex-emu:ubuntu-24.04\n\n# Run interactive container\ndocker run -it --rm supersunho/fex-emu:ubuntu-24.04\n\n# Execute x86 command directly\ndocker run --rm supersunho/fex-emu:ubuntu-24.04 FEXBash -c \"uname -a\"\n```\n \n### 💡 **Summary Of Image Tags**\n\n| Tag Category | Example | Description |\n| :------------------------ | :----------------------------- | :-------------------------------- |\n| **Latest Multi-Platform** | `latest` | Auto-selects optimal distribution |\n| **LTS Recommended** | `ubuntu-24.04`, `ubuntu-22.04` | Long-term support versions |\n| **Current Stable** | `fedora-40` | Latest stable Fedora |\n| **Version-Specific** | `ubuntu-24.04-2506` | Pinned FEX version 2506 |\n\n### 📦 **Available Image Tags**\n\n| Tag | Description |\n| :------------------ | :--------------------------------------- |\n| `latest` | Multi-platform auto-selection |\n| `ubuntu-24.04` | Ubuntu 24.04 LTS |\n| `ubuntu-22.04` | Ubuntu 22.04 LTS |\n| `ubuntu-24.04-2506` | Ubuntu 24.04 LTS (FEX Version: FEX-2506) |\n| `ubuntu-22.04-2506` | Ubuntu 22.04 LTS (FEX Version: FEX-2506) |\n| `fedora-40` | Fedora 40 |\n| `fedora-38` | Fedora 38 |\n| `fedora-40-2506` | Fedora 40 (FEX Version: FEX-2506) |\n| `fedora-38-2506` | Fedora 38 (FEX Version: FEX-2506) |\n\n### 🏷️ Image Naming Convention\n\nEach image tag follows a structured naming pattern composed of three components:\n\n```bash\nsupersunho/fex-emu:--\n```\n\n**Components Explained:**\n\n1. **RootFS OS** (``): The Linux distribution used as the root filesystem\n - `ubuntu` - Ubuntu Linux distribution\n - `fedora` - Fedora Linux distribution\n\n2. **RootFS Version** (``): The specific version of the root filesystem\n - For Ubuntu: `22.04`, `24.04` (LTS versions)\n - For Fedora: `38`, `40` (recent releases)\n\n3. **FEX Version** (``): The FEX-Emu project version used for the build\n - Format: `YYMM` (e.g., `2506` for June 2025 release)\n - Corresponds to official FEX-Emu release tags\n \n**Example Tags:**\n```bash\nsupersunho/fex-emu:ubuntu-24.04-2506 # Ubuntu 24.04 + FEX version 2506\nsupersunho/fex-emu:fedora-40-2506 # Fedora 40 + FEX version 2506\nsupersunho/fex-emu:ubuntu-22.04-2505 # Ubuntu 22.04 + FEX version 2505\nsupersunho/fex-emu:fedora-38-2505 # Fedora 38 + FEX version 2505\n```\n\n\n\n### Available Images\n\n```bash\n# Ubuntu-based images\n\ndocker pull supersunho/fex-emu:ubuntu-24.04 # Ubuntu 24.04 LTS\ndocker pull supersunho/fex-emu:ubuntu-22.04 # Ubuntu 22.04 LTS\n\n# Fedora-based images\n\ndocker pull supersunho/fex-emu:fedora-40 # Fedora 40\ndocker pull supersunho/fex-emu:fedora-38 # Fedora 38\n```\n\n## 💻 Usage Examples\n\n### Interactive x86 Shell\n\n```bash\ndocker run -it --rm supersunho/fex-emu:ubuntu-24.04\n\n# Inside container: now you can run x86 applications\n```\n\n### Run x86 Applications\n\n```bash\n# Run x86 applications through FEXBash\n\ndocker run --rm supersunho/fex-emu:ubuntu-24.04 \\\nFEXBash -c \"ls /usr/bin | head -10\"\n```\n\n## 🏗️ Architecture & Build Information\n\n- **Source**: Built from official [FEX-Emu project](https://github.com/FEX-Emu/FEX)\n- **Base Architecture**: ARM64 (AArch64) optimized\n- **Target Emulation**: x86 and x86_64 applications\n- **Build Platform**: Ubuntu 24.04 LTS base for maximum compatibility\n- **Supported Platforms**: `linux/arm64`\n\n## 📋 Supported RootFS Distributions\n\n| Distribution | Versions | Status |\n|--------------|----------|---------|\n| **Ubuntu** | 22.04, 24.04 | ✅ LTS Support |\n| **Fedora** | 38, 40 | ✅ Latest Releases |\n\n## 🔧 Technical Details\n\n### Container Features\n- **Multi-RootFS Support**: Choose between Ubuntu and Fedora environments\n- **Pre-configured FEX**: Ready-to-use x86 emulation environment \n- **ARM64 Optimized**: Native ARM64 builds for maximum performance\n- **LTS Stability**: Ubuntu 24.04 base ensures long-term support\n\n### Image Size\n- **Typical Size**: ~800MB - 1.2GB per image\n- **Optimization**: Multi-stage builds with aggressive cleanup\n- **Efficiency**: Shared layers between similar images\n\n## 📚 Documentation & Support\n\n- **FEX-Emu Project**: [GitHub Repository](https://github.com/FEX-Emu/FEX)\n- **FEX Documentation**: [Official Wiki](https://wiki.fex-emu.com) \n\n## ⚠️ Requirements\n\n- **Host Architecture**: ARM64/AArch64 system required\n- **Docker Version**: Docker 20.10+ recommended\n- **Platform**: Linux with ARM64 support\n\n## 🤝 Contributing\n\nThis project builds container images from the upstream FEX-Emu project. For FEX-related issues or contributions, please visit the [official FEX repository](https://github.com/FEX-Emu/FEX).\n\n---\n\n**Built with ❤️ for the ARM64 community**\n","has_starred","hub_user","immutable_tags_settings",{"_216":11,"_217":218},"enabled","rules",[219],".*","is_automated","permissions",{"_223":21,"_224":11,"_225":11},"read","write","admin","user","storage_size",217720077696,"isOrg","reponame","tag","sha256:982ea0ebbdffd7e4c202a498532132a16bf0f4589da73117610a146107967b40","canDeleteTags","isHubSbxKitsEnabled","currentTab","tagAttestations","displaySecurityMetadata","showSbxLogoOverride","showSbxAgenticPlatformBadge","routes/_layout.layers.$namespace.$reponame.$tag.(images).($imageUrlDigest)._index",{"_27":28,"_179":-7,"_177":-7,"_178":-7,"_29":242,"_35":232,"_245":-7,"_246":11},{"_31":32,"_33":34,"_35":36,"_37":38,"_39":40,"_41":243,"_61":62,"_63":34,"_64":65,"_66":67,"_68":69,"_70":71,"_72":50,"_73":62,"_74":59,"_75":21},[244],{"_44":45,"_35":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":-5,"_57":38,"_58":59,"_60":-5},"imageWithLayers","hasPermissionToViewRepoSettings","actionData","errors"]

supersunho/fex-emu:latest