Overview

Object Storage is commonly used for storing large amounts of unstructured data, such as images, videos, documents, backups, and log files. It provides scalable and highly available storage, making it suitable for Cloud-based applications and services.

​

Introduction

Object Storage on Replit provides a seamless way to store files persistently, allowing you to access your data across different environments, including development (the Replit Workspace) and production (Deployments). The table below helps you understand the problem and how the Object Storage solution resolves it.

​

Architecture

This section focuses on understanding the architecture of Object Storage and its components: Objects, Buckets, Replit Apps, and Deployments.

​

Model

The following are the components of Object Storage:

• Objects

Objects are files stored in the Replit system. They can be text files, images, configuration files, or any other data you want to save. When you perform actions like reading from or writing to files, you’re working with Objects.

• Buckets

Buckets are containers that hold multiple Objects. Imagine them as folders where you organize related files. When using Replit libraries, the default Bucket is automatically selected unless otherwise specified, and no configuration is needed. You’ll see the default configuration in the .replit file as shown below:

[objectStorage]
defaultBucketID = "replit-objstore-2671be20-ff2f-4b45-b882-bc823dc5b905"

• Replit Apps and Deployments

Replit App and Deployments are environments provided by Replit for executing code and hosting web applications. When working with Objects, Replit App, and Deployments, the first step is to access a Bucket, and then you can manage the Objects stored within it.

​

Getting started

Login to your Replit Workspace and create a Replit App. Refer to Introduction to workspace for the detailed steps.

Navigate to the Tools pane to find Object Storage. Alternatively, in any window, use the + sign to open a new tab and search for Object Storage.

Select the Create a Bucket button to create your Bucket.

Once you create a Bucket, a Bucket ID is generated. To view the Bucket ID, navigate to the Settings tab.

​

Manage Objects

Depending on your preferences and requirements, you can manage Objects by uploading, downloading, and deleting Objects within your Bucket using the Replit Object Storage Library or GCS APIs.

The Replit Object Storage libraries provide:

• A simplified interface for interacting with your Bucket
• Making it easier to perform common tasks like uploading, downloading, and deleting Objects

On the other hand, using GCS APIs directly gives you more control and flexibility over your Object management operations. This approach allows you to access advanced features and functionality provided by GCS, such as preconditions and lifecycle management. Using the GCS APIs is recommended if you are using a language other than Python or Typescript and cannot use a Replit library, or if you require more advanced functionality. You can read more about the GCS APIs here. Using GCS APIs directly enables access from environments where it isn’t possible to use a Replit library, such as other programming languages (i.e., Go or Java) or shell scripts.

In your Replit Workspace, you can start uploading files by dragging and dropping them into the Object Storage window or selecting Upload files or Upload folder. You can view all the files once you upload your folder/files. You can also organize all your files using the Create folder button. If you wish to delete a specific file, use the trashcan option against the specific file on the right side.

​

Using Replit Object Storage Library

The Replit Object Storage Library is available in Python and TypeScript. It helps you perform basic file operations. Use the Python library to create a client instance, get the default Bucket associated with the Replit App, write data to an Object named file.txt, and then read data from the same Object.

In your Replit App Workspace, navigate to the Commands tab to install the Replit Object Storage Package. The replit-object-storage package simplifies working with Object Storage by providing a Python client library. Learn more about the package by referring to the Replit Object Storage package overview.

The following example helps you understand how your files interact with Replit Object Storage using Python.

# Import the Replit Object Storage Library
from replit.object_storage import Client

# Create a client instance
client = Client()

# Write data to an Object with the name "file.txt"
client.upload_from_text("file.txt", file_contents)

# Read data from the Object named "file.txt"
obj = client.download_from_text("file.txt")
print("Content of 'file.txt':", obj)

Similarly, you can also use the Replit Object Storage Client library in Typescript and other languages.

If you don’t find a client library for the language of your choice, use one of the GCS Client Libraries or the GCS JSON API.