config.example.yaml

# VariObjectStorage Configuration Example

server:
  host: 0.0.0.0
  port: 8080
  shutdown_timeout: 60  # Graceful shutdown timeout in seconds (waits for active uploads/downloads)

logging:
  level: info    # debug, info, warn, error
  format: json   # json, console

# Authentication configuration (AWS Signature V4)
auth:
  enabled: true
  allow_anonymous: false  # Set to true to allow unauthenticated requests
  region: us-east-1       # Region for signature validation

  # Credentials file with access keys for S3 API authentication
  # JSON file format: {"credentials": [{"access_key_id": "...", "secret_access_key": "..."}]}
  credentials_file: /path/to/auth-credentials.json

backends:
  # Backend to use: aws-s3, azblob, gcs, or disk
  default: aws-s3

  # Amazon S3 Backend
  aws-s3:
    region: us-east-1
    # Credentials file with AWS access keys
    # JSON file format: {"access_key_id": "...", "secret_access_key": "..."}
    credentials_file: /path/to/aws-credentials.json
    # Optional: custom endpoint for S3-compatible services
    # endpoint: https://s3.amazonaws.com

  # Azure Blob Storage Backend
  azblob:
    # Credentials file with account name and key
    # JSON file format: {"account_name": "...", "account_key": "..."}
    credentials_file: /path/to/azure-credentials.json
    # Optional: custom container URL
    # endpoint: https://youraccount.blob.core.windows.net

  # Google Cloud Storage Backend
  gcs:
    project_id: YOUR_PROJECT_ID
    # Service account credentials file (standard GCP JSON key file)
    credentials_file: /path/to/gcp-credentials.json

  # Local Disk Backend
  disk:
    # Root directory for storing buckets and objects
    root_dir: /var/lib/variobjectstorage