Installation
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 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.
Development and debugging only
The Windows version of RustFS is intended for development and debugging only and is not recommended for production deployments. We recommend Linux for production workloads.
Change the default credentials immediately
After installation, set unique values for RUSTFS_ACCESS_KEY and RUSTFS_SECRET_KEY before exposing RustFS to a network. Do not use the well-known rustfsadmin value for either credential.
- For a Linux binary or systemd installation, set both values in
/etc/default/rustfs, then restart therustfsservice. - For Docker, Podman, or Docker Compose, pass both values as container environment variables when creating the container. Recreate an existing container if it was started without them.
Choose your path
| Your goal | Recommended path | Guide |
|---|---|---|
| Try RustFS on a local machine | One-command install script, or a container | Linux Quick Start · Container |
| 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 | Deploy with the Helm chart or the Operator | Cloud Native |
| Windows or macOS host | Native installation | Windows · macOS |
Compare deployment modes
| Mode | Nodes | Disks | Fault Tolerance | Typical Use |
|---|---|---|---|---|
| SNSD | 1 | 1 | None — rely on backups | Development, testing, and small non-critical workloads |
| SNMD | 1 | Multiple | Up to M parity disks within the node | Mid-sized, non-critical workloads on a single server |
| MNMD | 4+ | Multiple per node | Disk- and node-level via erasure coding across servers | Production workloads |
Checklist
Before any production deployment, work through the Pre-Installation Checklists — hardware, network, software, and security — to make sure your environment meets production requirements.