gitwtfhub

wtf is vaults3?

kodiqa-solutions/vaults3 — explained in plain English

Analysis updated 2026-05-18

793GoAudience · ops devopsComplexity · 3/5LicenseSetup · moderate

TL;DR

A single binary, S3 compatible object storage server with a built in web dashboard, using under 80MB of RAM, aimed at replacing MinIO or SeaweedFS.

Mindmap

mindmap
  root((VaultS3))
    What it does
      S3 compatible API
      Web dashboard
      Encryption at rest
    Tech stack
      Go
      BoltDB
      React
      Docker
    Use cases
      Self hosted S3
      MinIO replacement
      Multi tenant encryption
    Audience
      DevOps engineers
      Backend developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run a self hosted, S3 compatible storage server for an app that currently uses AWS S3.

REASON 2

Replace MinIO after it removed its free admin dashboard, keeping the same S3 API your tools already use.

REASON 3

Set up per bucket encryption keys so different tenants' data stays isolated in a shared storage server.

What's in the stack?

GoBoltDBReactDockerPrometheus

How it stacks up

kodiqa-solutions/vaults3gitlawb/zeromitchellh/hashstructure
Stars793803768
LanguageGoGoGo
Last pushed2023-01-03
MaintenanceDormant
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Single binary or Docker image, clustering and active-active replication are still labeled beta.

AGPL v3: you can use and modify it freely, but if you run a modified version as a network service, you must make your source code available to its users.

Wtf does this do

VaultS3 is a lightweight, S3 compatible object storage server that ships as a single binary with a built in web dashboard. It is positioned as an alternative to MinIO, SeaweedFS, and Garage, aimed at people who want an S3 compatible store without the memory footprint, multiple components, or licensing changes those other projects have run into. The README specifically calls out that MinIO removed its admin console from the free community edition and archived its open source repository, which is part of the motivation for building VaultS3. The server targets under 80 megabytes of RAM in a small deployment, needs no external database because it stores metadata in an embedded BoltDB key value store, and requires no Docker or other runtime dependencies beyond the compiled binary itself. It implements a large set of the S3 API, including multipart uploads, bucket policies, presigned URLs, range requests, object and bucket tagging, and virtual hosted style URLs, so it should work as a drop in replacement for existing tools built against AWS's S3 client libraries such as the AWS CLI, boto3, or the mc command. Security features include AES 256 GCM encryption at rest with either a static key or HashiCorp Vault backed keys, per bucket encryption keys so different tenants never share a key, and customer provided keys where the client supplies its own encryption key per request. It also supports multi node clustering built on Raft consensus for metadata and a hash ring for placing object data, plus active active replication between sites, though the README labels both of those clustering features as beta rather than fully stable, while the single node mode with erasure coding is described as stable and already running in production. The project is written in Go, released under the AGPL version 3 license, and includes a React based web dashboard, a command line client, Prometheus metrics, and Docker images for deployment. It also supports S3 Select for running SQL queries directly against CSV, JSON, and Parquet files without downloading them first.

Yoink these prompts

Prompt 1
Help me deploy VaultS3 with Docker and connect the AWS CLI to it as an S3 endpoint.
Prompt 2
Show me how to enable per bucket encryption keys in VaultS3 and rotate them.
Prompt 3
Walk me through setting up a 3 node VaultS3 cluster with Raft based metadata replication.
Prompt 4
Use VaultS3's S3 Select feature to run a SQL query against a CSV file I've stored.

Frequently asked questions

wtf is vaults3?

A single binary, S3 compatible object storage server with a built in web dashboard, using under 80MB of RAM, aimed at replacing MinIO or SeaweedFS.

What language is vaults3 written in?

Mainly Go. The stack also includes Go, BoltDB, React.

What license does vaults3 use?

AGPL v3: you can use and modify it freely, but if you run a modified version as a network service, you must make your source code available to its users.

How hard is vaults3 to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is vaults3 for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.