RustFS

نظره عامه ​

RustFS is the default object storage backend for إيلوم as of release 6.7.2-RC2. It is an Apache-2.0 S3-compatible object store written in Rust. The upstream chart is published at https://charts.rustfs.com and is bundled as a sub-chart of helm_aio.

When to use RustFS​

• New إيلوم installs that want the project's current default.
• Existing ميني آيو installs that want to move to a permissively licensed storage layer (Apache-2.0 vs the ميني آيو server's AGPL-3.0).
• Deployments that benefit from a smaller, Rust-based footprint at modest scale.

Enable RustFS as the active provider​

RustFS is enabled by default in 6.7.2-RC2 and later. On a net-new install, no Helm flag is required:

helm install ilum ilum/helm_aio

On an existing ميني آيو install, follow the migration playbook in Migrate Between Providers. The playbook keeps ميني آيو running side by side until the operator explicitly acknowledges the cutover.

Why Ilum ships a custom image​

The upstream RustFS console hardcodes its admin and S3 API endpoints to the host root. Embedding it in the إيلوم UI as a same-origin iframe would collide with the إيلوم SPA routes at / . The bundled ilum/rustfs:1.0.0-beta.1 image carries a patched console built with NEXT_PUBLIC_API_PREFIX=/rustfs/api. The patched build sends every S3 and admin request through /rustfs/api/... and strips the prefix from the SigV4 canonical string before signing. The إيلوم UI's nginx reverse proxy then strips /rustfs/api/ and forwards the un-prefixed request to the RustFS server, which verifies the signature against the same un-prefixed path.

The patch is being upstreamed to github.com/rustfs/console. Once the upstream tag includes the NEXT_PUBLIC_API_PREFIX knob, إيلوم will switch back to the stock upstream image.

The image build pipeline lives in ops/docker/ilum-rustfs/في المربع إيلوم monorepo.

Registry entry​

The chart ships the following registry defaults for RustFS:

objectStorage: 
  providers: 
    rustfs: 
      consolePath:  /rustfs/console/
      consoleMode:  same- origin

ال consoleMode: same-origin instructs the إيلوم UI to load the console iframe directly at /rustfs/console/ rather than rewriting the path. The patched console assets resolve relative to that base path.

Prometheus metrics​

RustFS observability is in active development at the time of this writing. The upstream rustfs-obs crate ships OpenTelemetry-based metrics, logs, and traces. A stable /metrics Prometheus-format endpoint has not yet been documented in the upstream README, and community issues (rustfs/rustfs#796, rustfs/rustfs#1228) track the work.

Until the upstream endpoint stabilizes, operators that need Prometheus-format RustFS metrics today should run the upstream's OTel collector reference stack (Grafana, Prometheus, and Jaeger) from the RustFS project's docker-compose.yml. Configure the RUSTFS_OBS_ENDPOINT environment variable in rustfs.extraEnv to point at the collector. This integration is operator-driven; إيلوم does not wire it automatically.

For Loki log shipping from the إيلوم core services (which write to the ملفات ILUM bucket on whichever provider is active), refer to the existing observability documentation. The log path is provider-agnostic.

Known limitations​

• Alpha upstream status. The bundled RustFS chart 0.0.99 advertises app version 1.0.0-alpha.99. Distributed mode is marked "under testing" in the upstream README. The bundled defaults run in standalone mode with a single replica and a single PVC.
• No Hydra OIDC auto-wiring in 6.7.2-RC2. Operators that need OIDC against the RustFS console must supply the integration through rustfs.extraEnv directly. The integration will stabilize in a future release.
• Patched console fork. Until the upstream NEXT_PUBLIC_API_PREFIX patch lands, إيلوم pins a custom image. The fork is small (under 50 lines across five files plus one new file) and tracked in ops/docker/ilum-rustfs/README.md.

Disable RustFS​

To roll back to ميني آيو or to disable RustFS in favour of an external S3 provider, set rustfs.enabled=false. The pre-upgrade hook detects existing RustFS PersistentVolumeClaims and refuses to proceed if disabling RustFS would orphan data. Follow Migrate Between Providers to disable RustFS safely.

Reference​

• Upstream chart on Artifact Hub: rustfs/rustfs
• Upstream server source: github.com/rustfs/rustfs
• إيلوم image source: ops/docker/ilum-rustfs/ in the monorepo
• Migration: Migrate Between Providers
• وثائق التفويض: Rotate Object Storage Credentials
• Helm values: Object Storage Helm Values