---
title: Hep.gg S3 Storage (LLM)
description: S3-compatible object storage on two instances. Buckets are per-user, each with its own service-account key pair.
---

# Hep.gg S3 Storage

S3-compatible object storage on two instances. Buckets are per-user; each
bucket has its own service-account key pair. You talk to it with any S3 client
(aws-cli, the AWS SDKs, rclone); there is no Hep.gg-specific data-plane API.

Endpoints:
  primary    https://s3.hep.gg                 (backed up; region ca-central-hydra-1)
  secondary  https://ca-east-hydra-1.s3.hep.gg (best-effort; region ca-east-hydra-1)

A bucket can be moved to the other region from the dashboard (Storage > Buckets >
Move). The move copies every object across, verifies, then deletes the original;
the bucket's access key is reissued (each region has its own credentials), so
fetch the new key afterwards. Moving onto primary requires Premium.

Auth: standard S3 signature v4 using your per-bucket access key + secret.
Strict SDKs require the matching region tag (above) and path-style addressing.

## Common commands

AWS CLI:
  aws --endpoint-url https://s3.hep.gg \
      --region ca-central-hydra-1 \
      s3 ls s3://my-bucket/

rclone config:
  type = s3
  provider = Other
  endpoint = https://s3.hep.gg
  region = ca-central-hydra-1
  force_path_style = true

## Public objects
Objects in a public bucket are downloadable anonymously at
https://s3.hep.gg/<bucket>/<key>. Use S3 presigned URLs for time-limited access
to private objects.

## Hep.gg dashboard (cookie auth - not for programmatic use)
  GET    /api/v1/storage/buckets
  POST   /api/v1/storage/buckets               { name, instance, visibility? }
  PATCH  /api/v1/storage/buckets/:id           { visibility }
  DELETE /api/v1/storage/buckets/:id
  GET    /api/v1/storage/buckets/:id/key
  POST   /api/v1/storage/buckets/:id/key/rotate
  POST   /api/v1/storage/buckets/:id/transfer    { destInstance } (move to other region)
  GET    /api/v1/storage/buckets/:id/transfer    (poll move progress)
  GET    /api/v1/storage/quota
  GET    /api/v1/storage/purchases
  POST   /api/v1/storage/purchases/trade       { bundle }   (bundle: 100gb | 500gb | 1tb; pays in Hep tokens)