vaultaire

module
v0.28.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 5, 2025 License: Apache-2.0

README ΒΆ

Vaultaire - Universal Storage Orchestration Engine

Apache 2.0 S3 Compatible

Turn any storage backend into intelligent, unified infrastructure

What is Vaultaire?

Vaultaire is a storage orchestration engine that provides a single S3-compatible API across multiple storage backends. Think of it as a universal translator for storage - use one API, store anywhere.

Three Ways to Use Vaultaire

πŸš€ stored.ge - Managed Storage for Developers
  • $3.99/TB/month
  • 100GB Seagate Lyve Cloud included
  • Perfect for indie developers
  • Sign up at stored.ge
🏒 stored.cloud - Enterprise Storage Platform
��️ Vaultaire Core - Self-Hosted Solution
  • Open source (Apache 2.0)
  • Bring your own backends
  • Deploy on your infrastructure
  • Get started below

Quick Start (Self-Hosted)

# Run with Docker
docker run -d \
  -p 9000:9000 \
  -v /etc/vaultaire:/config \
  vaultaire/core:latest

# Or build from source
git clone https://github.com/fairforge/vaultaire
cd vaultaire
make build
./bin/vaultaire serve
Features

βœ… Universal S3 API - Works with any S3 client
βœ… Multi-Backend Support - Mix Wasabi, R2, Hetzner, etc.
βœ… Intelligent Tiering - Automatic hot/cold data management
βœ… Erasure Coding - Built-in redundancy
βœ… Event Streaming - Full audit trail
βœ… ML-Ready - Predictive caching (Enterprise)

Architecture
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   S3 API    │────▢│   Engine    │────▢│   Drivers   β”‚
β”‚  (bucket/   β”‚     β”‚ (container/ β”‚     β”‚  (Multiple  β”‚
β”‚   object)   β”‚     β”‚  artifact)  β”‚     β”‚  Backends)  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
Read full architecture docs β†’
Supported Backends

βœ… Local filesystem
βœ… S3 / S3-compatible
βœ… Seagate Lyve Cloud
βœ… Wasabi
βœ… Cloudflare R2
βœ… Backblaze B2
βœ… MinIO
πŸ”„ Hetzner Storage Box (coming soon)
πŸ”„ Google Cloud Storage (coming soon)

Documentation

Architecture Overview
API Reference
Configuration Guide
Driver Development
Deployment Guide
Contributing Guidelines
Code of Conduct

Contributing
See CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
License
Apache 2.0 - see LICENSE
This project uses Apache 2.0 to ensure:

βœ… Enterprise-friendly usage
βœ… Patent protection for all users
βœ… Clear contribution guidelines
βœ… Compatible with commercial use

Why We Built This
Storage is fragmented. Every provider has different APIs, pricing, and capabilities. Vaultaire unifies them all behind a single, intelligent interface.
We believe in making enterprise-grade storage accessible to everyone through intelligent orchestration.
Status

🚧 Current Phase: MVP Development
πŸ“Š Progress: Step 47 of 500
🎯 Next Milestone: S3 DELETE/LIST operations
οΏ½οΏ½ Launch Target: Q1 2025

Built by @fairforge | Blog | Twitter

Directories ΒΆ

Path Synopsis
cmd
vaultaire command
cmd/vaultaire/main.go
cmd/vaultaire/main.go
internal
api
internal/api/auth.go
internal/api/auth.go
docs
internal/docs/openapi.go
internal/docs/openapi.go
drivers
internal/drivers/chunked_transfer.go
internal/drivers/chunked_transfer.go
gateway
internal/gateway/apikey.go
internal/gateway/apikey.go
gateway/cache
internal/gateway/cache/middleware.go
internal/gateway/cache/middleware.go
gateway/metrics
internal/gateway/metrics/collector.go
internal/gateway/metrics/collector.go
gateway/validation
internal/gateway/validation/routes.go
internal/gateway/validation/routes.go
ratelimit
internal/ratelimit/burst.go
internal/ratelimit/burst.go
storage
internal/storage/dedup.go
internal/storage/dedup.go

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL