Deployment

Choose the deployment method that fits your needs.

• Single Node

  ---

  Simple deployment for small-scale use.

  Single Node Guide

• Docker

  ---

  Quickest way to get started.

  Docker Guide

• Kubernetes

  ---

  Production-ready with Helm.

  Kubernetes Guide

• Multi-Server Cluster

  ---

  Distributed deployment with replication.

  Cluster Guide

• TLS/HTTPS

  ---

  Secure communication with TLS certificates.

  TLS Guide

• Production

  ---

  Best practices for production.

  Production Guide

Quick Comparison

Method	Use Case	Complexity
Single Node	Development, Small production	⭐ Easy
Docker	Quick testing, Development	⭐ Easy
Docker Compose	Multi-container testing	⭐⭐ Medium
Multi-Server Cluster	Enterprise, High availability	⭐⭐⭐ Advanced
Kubernetes	Cloud Native, Auto-scaling	⭐⭐⭐ Advanced
TLS/HTTPS	Production security	⭐⭐ Medium

Minimum Requirements

Resource	Development	Production
CPU	1 core	4+ cores
Memory	512 MB	4+ GB
Disk	1 GB	100+ GB
Network	-	1 Gbps+

Quick Start

docker run -d \
  --name hafiz \
  -p 9000:9000 \
  -p 9001:9001 \
  -e HAFIZ_ROOT_ACCESS_KEY=hafizadmin \
  -e HAFIZ_ROOT_SECRET_KEY=hafizadmin \
  ghcr.io/shellnoq/hafiz:latest

Access:

• S3 API: http://localhost:9000
• Admin UI: http://localhost:9001