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.
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 | 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 |
Checklist
Before any production deployment, work through the Pre-Installation Checklists — hardware, network, software, and security — to make sure your environment meets production guidance.