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

# Get started with Hivenet Object Storage

> Activate Object Storage, save your credentials, create a bucket, and upload your first object.

This guide takes you from activation to your first stored object and a client connection.

## What you'll need

* A Hivenet organization with **Object Storage** available in the console.
* A desktop browser.
* A secure place to save your access key ID and secret.
* A small test file with a simple name, such as `hello.txt`.

Confirm your organization's [billing arrangement](https://docs.hivenet.com/documentation/object-storage/usage-and-billing.md). For self-service storage, add enough credits to keep the shared organization balance positive before creating a bucket or uploading files. If you cannot add credits, ask the organization Owner.

Direct customers with an invoicing agreement follow their contract instead.

**1. Open Object Storage**

Sign in to the [Compute console](https://console.hivecompute.ai/), check the organization in the upper-left corner, and open **Object Storage**.

If your organization has already activated storage, skip the activation step. You still need your own active key to use bucket and object actions in the console. Joining an organization does not create one for you.

If **My keys** is empty, select **New key** and follow the credential-saving step below. If you already have an active key, continue to the bucket step.

**2. Activate storage**

Read the activation acknowledgment and select its checkbox. Then select **Activate Object Storage**.

Activation is permanent and creates your first access key. Stay in the flow to save its credentials.

**3. Save the credential pair**

Save both the access key ID and the secret access key. Select **Download credentials** or copy both values to secure storage.

Confirm that you have saved them before continuing.

> [!WARNING]
>
> The secret is shown once. Leaving the flow does not undo activation or remove the key. If you leave without saving it, follow the [lost-secret recovery steps](https://docs.hivenet.com/documentation/object-storage/access-keys.md#replace-a-lost-secret).

**4. Create your first bucket**

Enter a bucket name using 3–63 lowercase letters, numbers, and hyphens. Start and end with a letter or number, and do not use dots.

Review the **EU** region, organization access, and always-on server-side encryption. Then select **Create bucket**.

Every member of your organization can access this bucket. Its name must be available in the region.

You can choose **Skip for now** at the bucket step and create one later with **New bucket**.

**5. Upload a test object**

Open the bucket and select **Choose files**, or drag your test file into the upload area. Leave **Destination** empty to upload to the bucket root.

Review the selected file and start the upload. Wait for the result, then check that the object appears in the list.

Uploading to an existing name replaces the stored object.

**6. Download the object**

Open the object's options menu and select **Download**. Your browser handles the download.

Check that the downloaded file contains the data you uploaded.

**7. Make your first API call**

Choose [AWS CLI](https://docs.hivenet.com/documentation/object-storage/aws-cli.md), [Python or JavaScript](https://docs.hivenet.com/documentation/object-storage/sdks.md), or [rclone](https://docs.hivenet.com/documentation/object-storage/rclone.md).

Each guide starts with a listing request and includes the required Hivenet endpoint and path-style setting. Use your saved credential pair.

## If a step fails

* **Object Storage is missing:** Confirm the organization and ask your Hivenet contact to check access.
* **Buckets are visible but actions are disabled:** Check that you have your own active key in **My keys**. For self-service storage, also check the organization's credit balance. See [When credits run out](https://docs.hivenet.com/documentation/object-storage/usage-and-billing.md#when-credits-run-out).
* **The bucket name is taken:** Choose another name.
* **You lost the secret:** Create a replacement key and update your client before revoking the old key.
* **The client cannot connect:** Check the endpoint, signing region, and path-style setting in [Connection settings](https://docs.hivenet.com/documentation/object-storage/connection-settings.md).

See [Troubleshooting](https://docs.hivenet.com/documentation/object-storage/troubleshooting.md) for upload, download, and deletion errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.