S3 Quickstart: Store Your First Object

Hippius S3 is a distributed, S3-compatible storage service. This guide takes you from zero to your first file upload in under 5 minutes.

Create an Account

1. Go to console.hippius.com
2. Sign in with Google, GitHub, Apple, or a 12-word Access Key

No browser extension required.

Top Up Your Balance

S3 starts on pay as you go: $6 per TB per month, charged hourly from your account balance on what you store. So before you upload, add some money to your balance.

1. In the console, go to Billing.
2. Click + Top up and pay by card (min $10), Bitcoin (min $20), USDC on Base (min $5) or TAO (min $20).

Storing a lot? A monthly S3 plan covers a block of storage for a flat price, up to 22% cheaper per TB. See S3 plans and pay as you go.

Create S3 Credentials

1. In the console, go to S3 → S3 Buckets
2. Click + Create Master Token
3. Save your Access Key ID (starts with hip_) and Secret Key

warning

Store your secret key securely — it cannot be retrieved after creation.

A master token can do everything on your account. Scoped sub-tokens, rotation, and ACLs are in Advanced Usage.

Connection Details

Setting	Value
Endpoint	https://s3.hippius.com
Region	decentralized
Signature	AWS Signature V4
Addressing	Path-style

Always use https://s3.hippius.com. Wallets and browser extensions are not used for S3 auth. Your credentials are the hip_ access key and its secret.

Upload a File

Python (minio)

pip install minio

from minio import Minio
from io import BytesIO

client = Minio(
    "s3.hippius.com",
    access_key="YOUR_ACCESS_KEY",
    secret_key="YOUR_SECRET_KEY",
    secure=True,
    region="decentralized",
)

client.make_bucket("my-first-bucket")

content = b"Hello from Hippius!"
client.put_object(
    "my-first-bucket",
    "hello.txt",
    BytesIO(content),
    length=len(content),
    content_type="text/plain",
)

print("Uploaded successfully!")

JavaScript (minio)

npm install minio

const Minio = require("minio");

const client = new Minio.Client({
  endPoint: "s3.hippius.com",
  port: 443,
  useSSL: true,
  accessKey: "YOUR_ACCESS_KEY",
  secretKey: "YOUR_SECRET_KEY",
  region: "decentralized",
});

await client.makeBucket("my-first-bucket", "decentralized");

const content = Buffer.from("Hello from Hippius!");
await client.putObject("my-first-bucket", "hello.txt", content, {
  "Content-Type": "text/plain",
});

console.log("Uploaded successfully!");

AWS CLI

export AWS_ACCESS_KEY_ID="YOUR_ACCESS_KEY"
export AWS_SECRET_ACCESS_KEY="YOUR_SECRET_KEY"
export AWS_DEFAULT_REGION="decentralized"

aws s3 mb s3://my-first-bucket --endpoint-url https://s3.hippius.com

echo "Hello from Hippius!" > hello.txt
aws s3 cp hello.txt s3://my-first-bucket/hello.txt --endpoint-url https://s3.hippius.com

Download and Verify

Python (minio)

response = client.get_object("my-first-bucket", "hello.txt")
print(response.read().decode())
response.close()
response.release_conn()

JavaScript (minio)

const stream = await client.getObject("my-first-bucket", "hello.txt");
let data = "";
for await (const chunk of stream) {
  data += chunk.toString();
}
console.log(data);

AWS CLI

aws s3 cp s3://my-first-bucket/hello.txt - --endpoint-url https://s3.hippius.com

Next Steps

• Advanced Usage — presigned URLs, public buckets, ACLs, sub-tokens, large files
• Python, JavaScript, AWS CLI, rclone
• Compatibility matrix — every supported S3 operation
• Troubleshooting
• Pricing