Pithos

Warning

Beta Software: Pithos follows semantic versioning and is currently below v1.0.0. Breaking changes to the API, configuration format, or storage layout may occur between minor versions. Please review the changelog before upgrading. Pithos is not recommended for production use with important data.

Pithos is an S3-compatible object storage server designed for self-hosters, written in Go.

Features

• S3-compatible API with extensive operation support:
  • Bucket Operations: Create, Head, Delete, List buckets
  • Object Operations: Head, Get, Put, Delete, List objects
  • Multipart Upload Operations: Initiate, Upload, Complete, Abort, List
• Authentication using AWS Signature Version 4
• Authorization support via Lua scripts
• Configurable storage backends (local filesystem, S3, etc.)
• Prometheus metrics endpoint for monitoring
• Health monitoring endpoints
• Docker support for easy deployment

Quick Start

git clone https://github.com/jdillenkofer/pithos.git
cd pithos
go build -o pithos ./cmd/pithos.go
./pithos serve

Or with Docker:

docker build -t pithos .
docker run -p 9000:9000 -v $(pwd)/data:/data pithos

Documentation

For detailed documentation, see the docs directory:

• Getting Started – Installation, build, and Docker setup
• CLI Reference – All commands and options
• Configuration – Environment variables and authorization
• Storage Backends – Storage types and configuration examples
• Audit Logging – Audit middleware and verification
• Verifying Releases – Cosign verification

License

Pithos is licensed under the MIT License.