Installing RustFS on Linux
Choose a Linux deployment mode — SNSD, SNMD, or MNMD — and install RustFS on one or more servers.
This section covers installing RustFS on Linux servers. For a one-command trial installation, use the Quick Start. For a manual installation, pick one of the three deployment modes below — all three share the same prerequisites and service setup, and differ only in topology and volume configuration.
Change the default credentials immediately
After installation, set unique RUSTFS_ACCESS_KEY and RUSTFS_SECRET_KEY values in /etc/default/rustfs. Do not use the well-known rustfsadmin value for either credential. Restart the service with sudo systemctl restart rustfs after changing the file.
Single-node single-disk (SNSD)
One server, one data disk. The simplest mode, with no redundancy — a disk failure means data loss, so rely on backups. Suitable for development, testing, and small non-critical workloads.
→ Single Node Single Disk installation
Single-node multiple-disk (SNMD)
One server, multiple data disks. Erasure coding shards data across the disks, so the node tolerates a limited number of disk failures, but a whole-server failure still means data loss. Suitable for mid-sized, non-critical workloads on a single machine.
→ Single Node Multiple Disk installation
Multiple-node multiple-disk (MNMD)
Four or more servers, each with one or more disks. Erasure coding spans servers, providing disk- and node-level fault tolerance plus horizontal scalability. This is the mode for production workloads.
→ Multiple Node Multiple Disk installation
Before production
Work through the Pre-Installation Checklists — hardware, network, software, and security — before deploying to production. You can skip them for non-production deployments.