High-performance S3-compatible storage server written in Rust, optimized for speed and reliability.

• S3 API Compatibility: Complete implementation of core S3 operations
  • Bucket operations: Create, Delete, List, Head
  • Object operations: PUT, GET, DELETE, HEAD
  • Multipart uploads: Initiate, Upload Parts, Complete, Abort
  • Query operations: Versioning, ACL, Location, Batch Delete
• AWS Signature V4: Complete authentication implementation
• Chunked Transfer Encoding: Full support for AWS chunked transfers with signatures
• Async I/O: Built on Tokio and Axum for maximum concurrency
• Disk Persistence: Reliable filesystem-based storage
• CORS Support: Full cross-origin resource sharing support
• Zero-Copy Operations: Efficient memory usage for large files
• Exceptional Performance: 20,000+ operations per second

Also check the Web UI here: https://github.com/vibecoder-host/ironbucket-ui

./warp mixed --host=172.17.0.1:20000 --access-key=XXX --secret-key=XXX \
    --obj.size=100KB --duration=60s --autoterm

# Clone the repository
cd /opt/app/ironbucket

# Start IronBucket with Docker Compose
docker-compose up -d

# Verify it's running
docker-compose ps

# Check logs
docker-compose logs -f ironbucket

# Build from source
cargo build --release

# Run with environment variables
STORAGE_PATH=/s3 ./target/release/ironbucket

Configuration via environment variables or .env file:

# Storage
STORAGE_PATH=/s3                    # Directory for object storage
MAX_FILE_SIZE=5368709120            # Max file size (5GB default)

# Server
PORT=9000                           # Server port
RUST_LOG=ironbucket=info          # Logging level

# Authentication (S3 compatible)
ACCESS_KEY=root
SECRET_KEY=xxxxxxxxxxxxxxxxxxxxx

services:
  ironbucket:
    build: .
    ports:
      - "172.17.0.1:20000:9000"
    volumes:
      - ./s3:/s3
    environment:
      - STORAGE_PATH=/s3
      - RUST_LOG=ironbucket=warn,tower_http=warn
    restart: always

# Configure credentials
export AWS_ACCESS_KEY_ID=root
export AWS_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxxx
export AWS_ENDPOINT=http://172.17.0.1:20000

# Create a bucket
aws --endpoint-url $AWS_ENDPOINT s3 mb s3://my-bucket

# Upload a file
aws --endpoint-url $AWS_ENDPOINT s3 cp file.txt s3://my-bucket/

# List objects
aws --endpoint-url $AWS_ENDPOINT s3 ls s3://my-bucket/

# Download a file
aws --endpoint-url $AWS_ENDPOINT s3 cp s3://my-bucket/file.txt ./downloaded.txt

# Delete a file
aws --endpoint-url $AWS_ENDPOINT s3 rm s3://my-bucket/file.txt

# Remove bucket
aws --endpoint-url $AWS_ENDPOINT s3 rb s3://my-bucket

# Download warp
wget https://github.com/minio/warp/releases/download/v0.7.11/warp_0.7.11_Linux_x86_64.tar.gz
tar -xzf warp_0.7.11_Linux_x86_64.tar.gz

# Run mixed benchmark
./warp mixed \
  --host=localhost:20000 \
  --access-key=root \
  --secret-key=xxxxxxxxxxxxxxxxxxxxx \
  --autoterm \
  --duration=60s \
  --concurrent=50

# Run specific operation benchmarks
./warp get --host=localhost:20000 ...  # Test GET performance
./warp put --host=localhost:20000 ...  # Test PUT performance
./warp delete --host=localhost:20000 ... # Test DELETE performance

• Axum Web Framework: High-performance async HTTP server
• Tokio Runtime: Async I/O and task scheduling
• Chunked Transfer Parser: Handles AWS chunked encoding with signatures
• Storage Layer: Direct filesystem operations with optional caching
• Auth Middleware: AWS Signature V4 validation

# Check storage usage
du -sh /opt/app/ironbucket/s3/

# Clean up all storage
rm -rf /opt/app/ironbucket/s3/*

# View logs
docker-compose logs -f ironbucket

# Check container status
docker-compose ps

# Monitor performance
docker stats ironbucket

# Run in development mode
RUST_LOG=debug cargo run

# Run tests
cargo test

# Format code
cargo fmt

# Check for issues
cargo clippy

# Check what's using port 20000
netstat -tlnp | grep 20000

# Stop IronBucket
docker-compose down

# Fix permissions
sudo chown -R $USER:$USER /opt/app/ironbucket/s3

# Stop services
docker-compose down

# Clear storage
rm -rf s3/* redis-data/*

# Restart
docker-compose up -d

• Object versioning support (Completed)
• Bucket policies and IAM integration (Completed)
• Server-side encryption (Completed - AES-256-GCM)
• CORS configuration support (Completed)
• Object lifecycle management

• Bucket analytics and metrics
• Replication
• Event notifications

Comprehensive documentation is available in the /doc folder:

• Installation Guide - Complete installation instructions for various platforms
• Configuration Guide - Detailed configuration options and environment variables
• Security Guide - Security best practices and authentication setup

• API Reference - Complete S3 API endpoint documentation
• CLI Usage - Command-line interface guide and examples
• Node.js SDK - Node.js integration and AWS SDK usage
• Python SDK - Python boto3 integration guide
• Rust SDK - Rust AWS SDK integration examples

• Performance Guide - Performance tuning and optimization tips
• Troubleshooting - Common issues and solutions
• Documentation Index - Overview of all documentation

Contributions are welcome! Please ensure:

1. Code follows Rust best practices
2. All tests pass
3. Performance benchmarks show no regression
4. Documentation is updated

• GitHub Issues: Report bugs
• Discussions: Ask questions
• Security: Report vulnerabilities

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0) - see the LICENSE file for details.