RustFS

English Documentation |中文文档

Prerequisites

Package	Version	Download Link
Rust	1.8.5+	rust-lang.org/tools/install
protoc	31.1+	protoc-31.1-linux-x86_64.zip
flatc	24.0+	Linux.flatc.binary.g++-13.zip

Building RustFS

Generate Protobuf Code

cargo run --bin gproto

Using Docker for Prerequisites

- uses: arduino/setup-protoc@v3
  with:
    version: "30.2"

- uses: Nugine/setup-flatc@v1
  with:
    version: "25.2.10"

Adding Console Web UI

1. Download the latest console UI:

   wget https://dl.rustfs.com/artifacts/console/rustfs-console-latest.zip
   

2. Create the static directory:

   mkdir -p ./rustfs/static
   

3. Extract and compile RustFS:

   unzip rustfs-console-latest.zip -d ./rustfs/static
   cargo build
   

Running RustFS

Configuration

Set the required environment variables:

# Basic config
export RUSTFS_VOLUMES="./target/volume/test"
export RUSTFS_ADDRESS="0.0.0.0:9000"
export RUSTFS_CONSOLE_ENABLE=true
export RUSTFS_CONSOLE_ADDRESS="0.0.0.0:9001"

# Observability config
export RUSTFS_OBS_ENDPOINT="http://localhost:4317"

# Event message configuration
#export RUSTFS_EVENT_CONFIG="./deploy/config/event.toml"

Start the service

./rustfs /data/rustfs

Observability Stack

Deployment

1. Navigate to the observability directory:

   cd .docker/observability
   

2. Start the observability stack:

   docker compose -f docker-compose.yml  up -d
   

Access Monitoring Dashboards

• Grafana: http://localhost:3000 (credentials: admin/admin)
• Jaeger: http://localhost:16686
• Prometheus: http://localhost:9090