Skip to content

README.md

Latest commit

 

History

History
155 lines (98 loc) · 4.07 KB

README.md

File metadata and controls

155 lines (98 loc) · 4.07 KB

GitHub stars GitHub forks License Docker Pulls Last Commit Releases

English | 简体中文

⚠️ Privilege Notice

This container must run with the --privileged flag.

This grants the container near root-level access to the host, allowing it to directly modify the host’s network and system configuration.
If the container or image is compromised, the risk is equivalent to the entire device being fully controlled.

Only use this container if you fully understand the risks and trust the image source, especially in NAS environments such as fnOS and UGOS devices.

istoreos-docker-builder

🔗 Docker Hub：https://hub.docker.com/r/wukongdaily/openwrt-istoreos

Build a customized iStoreOS root filesystem for Docker using ImageBuilder.

This project provides reproducible build scripts and configurations for generating a minimal iStoreOS rootfs.

Features

  • Build iStoreOS rootfs for Docker
  • Support multiple targets (x86_64 / armsr)
  • Custom package selection
  • Preconfigured system files

Supported Systems List

Supports x86-64 and arm64

It is recommended to run on systems with a relatively new Linux kernel (6.x), such as fnOS, UGOS, OMV, Armbian, Debian, Ubuntu, etc.

✅ Tested and Verified

  • fnOS (x86-64, arm64)
  • UGOS (x86-64), arm64 (UGOS DH4300 PLUS tested)
  • openmediavault (OMV) (x86-64, arm64)
  • Armbian (x86-64, arm64)

❌ Not Recommended / Compatibility Issues

  • TrueNAS — Compatibility issues. Do not deploy.
  • QNAP and Synology — Compatibility issues. Do not deploy.
    These systems heavily customize the Linux kernel and networking stack (virtual switches, OVS, lxcbr0 bridges, permission controls, firewall rules), which differ significantly from standard Linux environments such as fnOS, UNRAID, and UGOS. It is recommended to use a virtual machine instead.
  • ZimaOS — Cannot run because Docker does not allow privileged mode. Do not deploy.

Customizations

  • Enabled rootfs tar output:
  • Custom ImageBuilder config (applied via config.seed)
CONFIG_TARGET_ROOTFS_TARGZ=y
  • Custom packages via packages.list
  • Custom system configuration via files/

ImageBuilder

ImageBuilder is provided by the official iStoreOS distribution:

https://fw.koolcenter.com/iStoreOS/ib/

https://site.istoreos.com/

(Please download from the official source)

Build Instructions

For each target (x86_64 / armsr):

  1. Download ImageBuilder

  2. Extract it:

    tar --zstd -xvf istoreos-imagebuilder-*.tar.zst

  3. Place it inside the target directory

  4. Run:

    ./build.sh

Project Structure

targets/
  x86_64/
    packages.list
    config.seed
    files/
  armsr/
    packages.list
    config.seed
    files/

Upstream Projects

This project does not include full source code. Please refer to upstream repositories for source code.

Author

Packaged by wukongdaily

❤️ Support

If this project is helpful to you, you can support the development:

  • ⭐ Star this repository
  • 🔄 Share with others
Buy Me A Coffee

Thank you for your support!