Dashboard Guide

Dashboard Overview

After logging in at cloudstorage.io/login, you are taken to the main dashboard. The dashboard is organized into several sections accessible from the sidebar navigation.

Dashboard API

All dashboard actions are backed by REST API endpoints. You can use these endpoints to automate account management. Authentication is handled via session cookies set at login.

Managing Access Keys

Access keys are the credentials used to authenticate S3 API requests. Each key pair consists of an access key ID (starts with CS) and a secret access key.

Your first key

When you sign up, your first access key is created automatically. The signup response includes both the access key and secret key:

POST /api/auth/signup
{
  "name": "Jane Doe",
  "email": "[email protected]",
  "password": "secure-password"
}

Response:
{
  "user": { "id": "...", "name": "Jane Doe", "email": "[email protected]" },
  "storage": {
    "accessKey": "CSXXXXXXXXXXXXXXXXXX",
    "secretKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "bucket": "jane-default",
    "endpoint": "https://s3.cloudstorage.io"
  }
}

Creating additional keys

You can create up to 5 access keys per account. This is useful for separating credentials across different applications or environments (e.g., production vs. staging).

Deleting keys

To revoke access for a specific credential, click the delete button next to the key in the dashboard. This takes effect immediately -- any requests signed with the deleted key will return 403 AccessDenied.

Managing Buckets

Buckets are the top-level containers for organizing your objects. You can have up to 10 buckets per account.

Default bucket

A default bucket is created when you sign up. You can start uploading immediately without any additional setup.

Creating buckets

From the dashboard, navigate to the Buckets section and click Create Bucket. Bucket names must:

• -Be between 3 and 63 characters long
• -Contain only lowercase letters, numbers, and hyphens
• -Start and end with a letter or number
• -Be unique within your account

You can also create buckets via the S3 API or the dashboard API:

# Via Dashboard API
POST /api/buckets
{ "name": "my-new-bucket" }

# Via S3 API (AWS CLI)
aws s3 mb s3://my-new-bucket --endpoint-url https://s3.cloudstorage.io

Bucket list view

The dashboard shows each bucket with:

Deleting buckets

A bucket must be empty before it can be deleted. Remove all objects first, then delete the bucket from the dashboard or via the S3 API. The default bucket created at signup cannot be deleted.

Understanding Storage Usage

The usage section gives you visibility into how much storage you are consuming relative to your plan.

Current usage

The dashboard displays a progress bar showing your current storage consumption against your plan limit. This data is also available via the API:

GET /api/usage

Response:
{
  "current": {
    "bytes": 5368709120,
    "formatted": "5.0 GB"
  },
  "plan": {
    "bytes": 1099511627776,
    "formatted": "1.0 TB",
    "tb": 1
  },
  "history": [
    { "date": "2026-03-01", "bytes": 4294967296 },
    { "date": "2026-03-15", "bytes": 4831838208 },
    { "date": "2026-04-01", "bytes": 5368709120 }
  ]
}

Usage history

The dashboard includes a chart showing your storage usage over time. This helps you understand growth trends and plan capacity ahead of time. Data points are recorded periodically and returned in the history array.

Quota enforcement

CloudStorage enforces storage quotas at the S3 proxy layer. When you attempt to upload a file that would push your total usage beyond your plan limit:

• -The upload is rejected with a 403 QuotaExceeded error
• -Existing data remains accessible for reads, downloads, and deletes
• -To resume uploading, either delete existing data or upgrade your plan

Plan Management

CloudStorage uses a simple, transparent pricing model: $5 per TB per month. Choose anywhere from 1 TB to 50 TB.

Pricing breakdown

Adjusting your plan

Use the slider in the dashboard to adjust your storage allocation. Changes take effect immediately.

• -Upgrading: Your new quota is available immediately. You are billed the prorated difference for the remainder of the billing cycle.
• -Downgrading: You can only downgrade to a level at or above your current usage. If you are using 3 TB, you cannot downgrade below 3 TB until you delete data.

What every plan includes

Need more than 50 TB?

For storage needs beyond 50 TB, contact us at [email protected] for custom pricing and dedicated infrastructure options.