Generate a RustFS config file before you deploy

Answer a few questions to produce a ready-to-use /etc/default/rustfs file — ports, volumes, credentials, logging, and OpenTelemetry in one place.

S3 API port

:9000

Console port

:9001

Log level

error

Config input

Values map directly to environment variables read by RustFS.

Network

S3 API portRUSTFS_ADDRESSConsole portRUSTFS_CONSOLE_ADDRESS

Enable Virtual Host Mode

Storage

VolumesRUSTFS_VOLUMES

The VOLUMES value depends on your installation topology. Please refer to our installation topology selection

Erasure Coding (EC)RUSTFS_STORAGE_CLASS_STANDARD

Best EC config? See our EC Calculator.

Credentials

Access keyRUSTFS_ACCESS_KEYSecret keyRUSTFS_SECRET_KEY

Do not use rustfsadmin. Set strong, unique access and secret keys before starting the server.

Key management (KMS)

Enable KMS

Runtime

Enable ConsoleLog levelRUSTFS_OBS_LOGGER_LEVELLog directoryRUSTFS_OBS_LOG_DIRECTORY

Observability

Configure OpenTelemetryOTEL endpointRUSTFS_OBS_ENDPOINT

Deployment notes

Config path/etc/default/rustfs

Credentialsmust be unique

File permissionschmod 600

For detailed usage of each configuration, refer to the official documentation.

Need a deployment review?

Share your topology, volume layout, and observability targets with the RustFS team before going to production.

rustfs config output

Copy this file to /etc/default/rustfs and restart the service.

/etc/default/rustfs

# RustFS configuration file
# Generated by https://rustfs.com/rustfs-config-generator
RUSTFS_ADDRESS=":9000"
RUSTFS_CONSOLE_ADDRESS=":9001"
RUSTFS_VOLUMES=/data
RUSTFS_ACCESS_KEY="<your access key>"
RUSTFS_SECRET_KEY="<your secret key>"
RUSTFS_CONSOLE_ENABLE=true
RUSTFS_OBS_LOGGER_LEVEL=error
RUSTFS_OBS_LOG_DIRECTORY=/var/log/rustfs
RUSTFS_OBS_ENDPOINT=http://localhost:4318

Defaults follow the official RustFS install template. Replace the access and secret key placeholders with strong, unique credentials before starting the server.