Buckets & Files

Manage your object storage buckets and files using the dashboard or any S3-compatible tool.

Using the Dashboard

The ScallerFox dashboard provides a file browser for managing your buckets and objects. Navigate to Object Storage → your subscription → Buckets tab.

Create a Bucket

Go to the Buckets tab in your subscription
Click Create Bucket
Enter a unique bucket name
Optionally add a description
Click Create

Upload Files

Click on a bucket to open the file browser
Click the Upload button or drag and drop files
Files are uploaded directly to the current folder path
View progress and confirmation in the dashboard

Manage Files

From the dashboard you can:

Browse folders and navigate paths
Download files directly
Rename objects
Delete individual or multiple files
Generate presigned download URLs
Create folders

Using S3-Compatible Tools

All S3 SDKs and tools work with ScallerFox Object Storage. Configure your S3 client with the gateway URL and access credentials from your dashboard.

Required Credentials

Get these from your subscription's Access Keys tab:

Endpoint:https://s3.scallerfox.com

Access Key ID:SF... (from dashboard)

Secret Key:shown once when key is created

Region:auto

AWS CLI Example

# Configure AWS CLI
aws configure
AWS Access Key ID [None]: SFyouraccesskey
AWS Secret Access Key [None]: your-secret-key
Default region name [None]: auto
Default output format [None]: json

# List buckets
aws s3 ls --endpoint-url https://s3.scallerfox.com

# Upload a file
aws s3 cp ./myfile.jpg s3://my-bucket/uploads/ --endpoint-url https://s3.scallerfox.com

# Download a file
aws s3 cp s3://my-bucket/uploads/myfile.jpg ./myfile.jpg --endpoint-url https://s3.scallerfox.com

# Sync a directory
aws s3 sync ./uploads/ s3://my-bucket/uploads/ --endpoint-url https://s3.scallerfox.com

Python boto3 Example

import boto3

client = boto3.client(
    's3',
    endpoint_url='https://s3.scallerfox.com',
    aws_access_key_id='SFyouraccesskey',
    aws_secret_access_key='your-secret-key',
    region_name='auto'
)

# Upload file
client.upload_file('myfile.jpg', 'my-bucket', 'uploads/myfile.jpg')

# Download file
client.download_file('my-bucket', 'uploads/myfile.jpg', 'myfile.jpg')

# List objects
response = client.list_objects_v2(Bucket='my-bucket')
for obj in response.get('Contents', []):
    print(obj['Key'], obj['Size'])

Best Practices

File Organization

Use path prefixes to organize files (e.g., images/2024/, backups/monthly/)
Use unique filenames (add timestamps or UUIDs) to avoid conflicts
Group related files in the same path for easier management

Large Files

Use multipart upload for files larger than 100 MB — it is automatic with most S3 SDKs
ScallerFox supports multipart uploads up to 5 TB per object

Access Control

Create separate access keys for different applications
Attach the minimum required policy to each key (principle of least privilege)
Set expiration dates on access keys for temporary access