RustFS Installation Guide
Choose the right RustFS deployment path: local trial, single-node or multi-node production, containers, and Kubernetes.
RustFS is a distributed object storage system written in Rust, fully compatible with the S3 protocol and released under the Apache 2.0 license. It runs on Linux, Windows, macOS, FreeBSD, and containers, across x86, ARM, RISC-V, and other CPU architectures. To learn more about the project itself, see What is RustFS?.
Choose Your Path
| Your goal | Recommended path | Guide |
|---|---|---|
| Try RustFS on a local machine | One-command install script, or a container | Linux Quick Start · Docker |
| Single-server production | SNSD (one disk) or SNMD (multiple disks) | Installing RustFS on Linux |
| Multi-server production cluster | MNMD, after completing the production checklists | Multiple Node Multiple Disk · Checklists |
| Kubernetes / cloud-native | Container orchestration deployment | Cloud Native |
| Windows or macOS host | Native installation | Windows · macOS |
Deployment Mode Comparison
| Mode | Nodes | Disks | Fault Tolerance | Typical Use |
|---|---|---|---|---|
| SNSD | 1 | 1 | None — rely on backups | Development, testing, low-density non-critical business |
| SNMD | 1 | Multiple | Up to M parity disks within the node | Medium, non-critical business on a single server |
| MNMD | 4+ | Multiple per node | Disk- and node-level via erasure coding across servers | Production workloads |
Production Checklists
Before any production deployment, work through the Pre-Installation Checklists — hardware, network, software, and security — to make sure your environment meets production guidance.