CLI Reference

The rustfs binary ships three subcommands. Running rustfs with no subcommand starts the server.

Subcommands

rustfs server /data/rustfs
rustfs info --all --json
rustfs tls inspect --path /etc/rustfs/tls

Legacy invocation compatibility

Arguments are preprocessed for backward compatibility, so older invocation styles keep working:

Server flags

Every server flag has an environment variable equivalent; the flag wins when both are set.

:::note If neither --access-key/--secret-key nor their file variants are provided, the server falls back to the built-in default credentials (rustfsadmin/rustfsadmin) and logs a warning. Set real credentials for any non-throwaway deployment. :::

Volume syntax

Volumes are passed as positional arguments (or via RUSTFS_VOLUMES) and are space-separated.

Ellipses expansion

A volume token may contain one or more {N...M} ranges, which expand numerically:

# Expands to /data/rustfs0 /data/rustfs1 /data/rustfs2 /data/rustfs3
rustfs server /data/rustfs{0...3}

# Multi-node: expands across hosts and disks
rustfs server http://node{1...4}:9000/data/rustfs{0...3}

Rules verified from the parser:

• The range format is {N...M} where N and M are decimal or hexadecimal positive integers and M must be greater than N.
• A single token may carry multiple ranges (e.g. host range plus disk range); all combinations are expanded.
• The maximum expanded size of one range is 10,000 entries.

Multiple pools

Separate server pools are expressed as space-separated groups of endpoints. Each argument (one per space) forms its own expansion group:

rustfs server http://node{1...4}:9000/data/rustfs{0...3} http://node{5...8}:9000/data/rustfs{0...3}

When set through the environment, the same string goes into RUSTFS_VOLUMES:

export RUSTFS_VOLUMES="http://node{1...4}:9000/data/rustfs{0...3}"
rustfs server