> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tensorpool.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Object Storage Commands

> CLI reference for S3-compatible object storage management

Manage S3-compatible object storage with the `tp object-storage` command group.

## Commands

* `tp object-storage enable` - Enable object storage for your organization
* `tp object-storage disable` - Disable object storage
* `tp object-storage credentials` - Get S3 access credentials
* `tp object-storage configure` - Get client configuration snippets
* `tp object-storage bucket list` (`ls`) - List buckets
* `tp object-storage bucket create` - Create a bucket
* `tp object-storage bucket delete` (`rm`) - Delete a bucket

***

## tp object-storage enable

Enable object storage for your organization. This is idempotent — calling it again returns your existing credentials.

```bash theme={null}
tp object-storage enable
```

Returns your S3 access key, secret key, endpoint, and region.

***

## tp object-storage disable

Disable object storage for your organization.

```bash theme={null}
tp object-storage disable
```

<Warning>
  Disabling object storage removes access to all buckets and data. Back up important data first.
</Warning>

***

## tp object-storage credentials

Get your active S3 credentials for object storage.

```bash theme={null}
tp object-storage credentials
```

Returns:

* Access key ID
* Secret access key
* S3 endpoint URL
* Region

***

## tp object-storage configure

Get ready-to-use configuration snippets for S3 clients.

### rclone

```bash theme={null}
tp object-storage configure rclone
```

Outputs configuration for `~/.config/rclone/rclone.conf`.

***

## tp object-storage bucket list

List all buckets visible to your organization. Alias: `tp object-storage bucket ls`.

```bash theme={null}
tp object-storage bucket list
```

***

## tp object-storage bucket create

Create a new bucket.

```bash theme={null}
tp object-storage bucket create <bucket_name>
```

**Arguments:**

* `bucket_name` - Name for the new bucket (required, positional)

Bucket names must follow S3 naming rules: 3–63 characters, lowercase letters/numbers/periods/hyphens, cannot be an IP address format.

**Example:**

```bash theme={null}
tp object-storage bucket create training-datasets
```

***

## tp object-storage bucket delete

Delete an empty bucket. Alias: `tp object-storage bucket rm`.

```bash theme={null}
tp object-storage bucket delete <bucket_name>
```

**Arguments:**

* `bucket_name` - Name of the bucket to delete (required, positional)

<Warning>
  The bucket must be empty before it can be deleted. Remove all objects first.
</Warning>

**Example:**

```bash theme={null}
tp object-storage bucket delete old-datasets
```

***

## Workflow Example

```bash theme={null}
# 1. Enable object storage
tp object-storage enable

# 2. Create a bucket for your project
tp object-storage bucket create my-project

# 3. Configure rclone
tp object-storage configure rclone

# 4. Upload data using standard S3 tools
rclone copy ./dataset tp:my-project/dataset/

# 5. List your buckets
tp object-storage bucket list
```

## Next Steps

* [Object Storage Overview](/features/object-storage)
* [Pricing](/resources/pricing)