{"id":28819447,"url":"https://github.com/supersunho/docker-fex-emu","last_synced_at":"2026-01-08T05:08:39.143Z","repository":{"id":298803346,"uuid":"1001174674","full_name":"supersunho/docker-fex-emu","owner":"supersunho","description":"🚀 ARM64-native FEX-Emu containers with API-driven automation, multi-distribution support, and selective build system for high-performance x86 emulation","archived":false,"fork":false,"pushed_at":"2025-06-13T02:02:10.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-13T02:20:01.243Z","etag":null,"topics":["arm64","automation","cross-platform","docker","emulator","fedora","fex-emu","multi-platform","squashfs","ubuntu","x86-emulation"],"latest_commit_sha":null,"homepage":"https://github.com/supersunho/docker-fex-emu","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/supersunho.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-13T00:20:03.000Z","updated_at":"2025-06-13T02:02:14.000Z","dependencies_parsed_at":"2025-06-13T02:32:59.819Z","dependency_job_id":null,"html_url":"https://github.com/supersunho/docker-fex-emu","commit_stats":null,"previous_names":["supersunho/docker-fex-emu"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/supersunho/docker-fex-emu","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-fex-emu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-fex-emu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-fex-emu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-fex-emu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/supersunho","download_url":"https://codeload.github.com/supersunho/docker-fex-emu/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-fex-emu/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260625198,"owners_count":23038166,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arm64","automation","cross-platform","docker","emulator","fedora","fex-emu","multi-platform","squashfs","ubuntu","x86-emulation"],"created_at":"2025-06-18T20:02:43.619Z","updated_at":"2026-01-08T05:08:39.138Z","avatar_url":"https://github.com/supersunho.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 FEXBash Base Images for ARM64 (FEX-2507)\n\n\u003cp\u003e\n  \u003cimg src=\"https://img.shields.io/github/stars/supersunho/docker-fex-emu?style=for-the-badge\u0026logo=github\u0026color=gold\" alt=\"GitHub Stars\"/\u003e\n  \u003cimg src=\"https://img.shields.io/github/forks/supersunho/docker-fex-emu?style=for-the-badge\u0026logo=github\u0026color=blue\" alt=\"GitHub Forks\"/\u003e\n  \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/supersunho/docker-fex-emu/builder.yml?style=for-the-badge\u0026logo=github\u0026color=green\" alt=\"Build Status\"/\u003e  \n  \n\u003c/p\u003e\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:\u003crootfs-os\u003e-\u003crootfs-version\u003e-\u003cfex-version\u003e\n```\n\n**Components Explained:**\n\n1. **RootFS OS** (`\u003crootfs-os\u003e`): The Linux distribution used as the root filesystem\n\n    - `ubuntu` - Ubuntu Linux distribution\n    - `fedora` - Fedora Linux distribution\n\n2. **RootFS Version** (`\u003crootfs-version\u003e`): The specific version of the root filesystem\n\n    - For Ubuntu: `22.04`, `24.04` (LTS versions)\n    - For Fedora: `38`, `40` (recent releases)\n\n3. **FEX Version** (`\u003cfex-version\u003e`): 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\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### 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 \u0026 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\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\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 \u0026 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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupersunho%2Fdocker-fex-emu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsupersunho%2Fdocker-fex-emu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupersunho%2Fdocker-fex-emu/lists"}