S4 is a lightweight, self-contained S3-compatible storage solution with a web-based management interface.
Perfect for POCs, development environments, demos, and simple deployments where a full-scale object storage solution is overkill.
It combines Ceph RADOS Gateway (RGW) backed by a standard filesystem and a modern UI into a single, easy-to-deploy container.
S4 provides full S3 API compatibility while requiring minimal resources and configuration.
Quick Start (local)
# Run S4 with persistent storage podman run -d \ --name s4 \ -p 5000:5000 \ -p 7480:7480 \ -v s4-data:/var/lib/ceph/radosgw \ quay.io/rh-aiservices-bu/s4:latest # Access the web UI open http://localhost:5000 # Use S3 API with default credentials export AWS_ACCESS_KEY_ID=s4admin export AWS_SECRET_ACCESS_KEY=s4secret export AWS_ENDPOINT_URL=http://localhost:7480 aws s3 mb s3://my-bucket
Quick Start (OpenShift/Kubernetes)
# Clone the repository git clone https://github.com/rh-aiservices-bu/s4.git cd s4 # Install with Helm helm install s4 ./charts/s4 --namespace s4 --create-namespace # Access the web UI (OpenShift - route is created automatically) oc get route s4 -n s4 -o jsonpath='{.spec.host}' # Access the web UI (Kubernetes - port forward) kubectl port-forward svc/s4 5000:5000 -n s4 # Then open http://localhost:5000
For advanced configuration options (authentication, storage sizing, ingress, etc.), see the Deployment Guide.
User Guide
For detailed instructions on using S4 — browsing storage, managing buckets, transferring files, importing HuggingFace models, and more — see the User Guide.
Key Features
- S3-Compatible API - Full AWS S3 API compatibility on port 7480
- Web Management UI - Modern React interface for storage operations on port 5000
- Lightweight - Single container deployment with minimal resources needed
- Bucket Management - Create, list, and delete S3 buckets
- Object Operations - Upload, download, browse, and delete objects
- Standard Filesystem Operations - Browse and manage mounted filesystem/PVC storage
- Cross-Storage Transfers - Transfer files between storage locations in any combination (S3 ↔ PVC, S3 ↔ S3, PVC ↔ PVC)
- Bucket Notifications - Webhook-based notifications for object changes (create, modify, delete)
- HuggingFace Integration - Direct model import from HuggingFace Hub
Documentation
- Getting Started - Installation, configuration, and quick start guides
- Architecture - System design, components, and data flow
- API Reference - Complete API documentation with examples
- Development - Contributing, testing, and development guides
- Deployment - Docker, Kubernetes, OpenShift, and production deployment
- Security - Security policy, authentication, and best practices
- Operations - Monitoring, troubleshooting, and FAQ
License
Apache 2.0