> For the complete documentation index, see [llms.txt](https://docs.nebulablock.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nebulablock.com/products/object-storage/quickstart.md).

# Quickstart

Create your first Nebula Block object storage workspace and bucket, then upload and delete files.

## Starting Your Object Storage

1. Navigate to the **Object Storage** tab **(1)**, and click **Create** **(2)**.

   ![1.1](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-7380fb7eefc8888b8640327248de949eb70379a3%2F1.jpg?alt=media)
2. Select your configuration, a **unique name** and click **Create**.

   > **Note:** The name of object storage should not contain a space.

   ![1.2](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-eee9f0e84bcc346d80affed77d00c62fd33b8948%2F2.jpg?alt=media)
3. Your new storage deployment should now appear in the list. Click **View** to check the details of the object storage

   ![1.3](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-01b8052ed70b67e8d8324a7b1482b8446a72a512%2F3.jpg?alt=media)
4. The object storage information contains your usage status, billing info and s3 keys info. You can use the key and s3cmd to access your object storage

   ![1.4](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-b7dcc57d7ffc4073b14bd0327f2208b6645f30bf%2F5.jpg?alt=media) [s3cmd set up for Linux/macOS](/products/object-storage/s3cmd-linux-macos.md) [s3cmd set up for Windows](/products/object-storage/s3cmd-windows.md)

> **Note:** Storage names are account-unique.

## Create Your Bucket

1. Navigate to the **Buckets** tab **(1)**, and then click **Create Bucket** **(2)**.

   ![2.1](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-7c1d151c67163d70e031905951e81bfb8e6bdf59%2F6.jpg?alt=media)
2. Type in your bucket name.

   ![2.2](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-606f19dcb677de347d0b9c9d2e0a9bbea81683b2%2F7.jpg?alt=media)

   > **Note:** Bucket names must be globally unique. If s3cmd fails to create one, try another name.\
   > Bucket name should follow these rules:
   >
   > * Only lowercase letters (`a-z`), numbers (`0-9`), and hyphens (`-`) are allowed
   > * Must begin with a letter or number
   > * Length must be between **3 to 63 characters**
   > * Cannot contain uppercase letters, underscores (`_`), spaces, or other special characters
   > * Avoid starting or ending with a hyphen (`-`)
3. Once the bucket name meets the requirements, it will appear in the list below.

   ![2.3](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-47454cb6d1d11f7fb554f5c9a7c49556c113ef0e%2F8.jpg?alt=media)

## Upload Your File

1. In the bucket view, you can upload files by clicking the **Upload** button **(1)**. Next, click the **Upload File** button **(2)** to select a file from your local system. Finally, click the **Upload** button **(3)** to upload the selected file to your bucket.

   ![3.1](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-2542714dd21c2a24649b53a7a019f26246dbd05b%2F9.jpg?alt=media)

   > **Note:** The file size must not exceed **50 MB**.\
   > Folder and multiple file upload features are coming soon.\
   > For now, please use **s3cmd** to upload entire folders.
2. File has been uploaded successfully.

   ![3.2](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-d3fd610442f9f4dec8c9dfb037f7d50d5854b634%2F10.jpg?alt=media)
3. If your bucket already contains folders, you can customize the upload path for your file. Select **Path**, then choose the folder where you want to upload the file.

   ![3.3](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-20936fb5755bc709d8c36a320c183ef38845854f%2F11.jpg?alt=media)

## Delete Your File

1. You can delete multiple files and folders in your bucket at once. Select the files and folders **(1)**, then click the **Delete** button.\
   The selected items will be permanently deleted.

   ![4.1](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-af3d65c3fb1728d0ede9c35a1465a0eadf9dc6a8%2F12.jpg?alt=media) ![4.1](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-86871631fe0299da42746dc8e44b3f84ba039c24%2F13.jpg?alt=media) ![4.1](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-52e6b427b3ce1aaa513aa36e0a20ea4511536504%2F14.jpg?alt=media)

## Delete Your Bucket

1. In the list of your buckets, you can delete a bucket by clicking the **Delete** button.

   ![5.1](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-40cdcb749e086fd1e3df08a250773fba2f196084%2F15.jpg?alt=media) ![5.2](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-f2893532c1c8e37fc0162e93b7a44ea94abe2808%2F16.jpg?alt=media) ![5.3](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-859db1d50e0d8967e2315eab2e7b86ec82455844%2F17.jpg?alt=media)

   > **Warning:** Deleting a bucket will permanently remove the bucket along with all its contents. This action cannot be undone.

## Delete Your Object Storage

To remove your storage:

1. Go to the **Object Storage** tab.
2. Click **Delete** on the deployment you want to remove.

   ![6.1](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-4db06b4217b2f41567021c0e0ab98972b0f71a42%2F18.jpg?alt=media)
3. Confirm the deletion.

   ![6.2](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-617950a035b8add3d00ce0ec15c848b2c68e71f3%2F19.jpg?alt=media)
4. Use the **Active** filter to view object storage that are **Ready** or **Deleted**, **Disabled**.

   ![6.3](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-998f9506a2e6e1c84615b803816b1723ae3bd6ad%2F4.jpg?alt=media)

## Billing

Your deployment shows:

* Storage Usage: How much data you're storing.
* Bandwidth Usage: How much data has been transferred out.
* Current Charges: The total charges incurred so far, calculated by a rate on your storage usage and a rate on your bandwidth usage.

The values are updated hourly. To view pricing:

* Go to your storage deployment's **Details** page.

![7.1](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-f67b0bd964ec52055ee54f04593b9d04b3bda989%2F5.png?alt=media)

* Or check the pricing when selecting your configuration

![7.2](https://540120125-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXZhubbpeVAa2uzXxQcny%2Fuploads%2Fgit-blob-6d344960c268ff7d6c4e629d1748772003e10544%2F6.png?alt=media)