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.
Développement et débogage uniquement
La version Windows de RustFS est destinée uniquement au développement et au débogage et n’est pas recommandée pour les déploiements en production. Pour la production, nous recommandons Linux.
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.