Filebase
Search…
Getting Started Guide
This guide walks through navigation and common tasks on Filebase using the Filebase web console.

Getting Started Guide

To download a PDF version of this guide, click here.

Signing up for Filebase

Filebase uses a web based console that can be found at https://filebase.com.
Existing accounts can go directly to https://filebase.com.
1. To sign up for a Filebase account, navigate to https://filebase.com. To make a new account, click the ‘Sign Up’ button in the top right corner of the webpage.
2. Next, fill out the fields of the form, including an email address and password, and agree to the Filebase terms to create your account.
3. You will receive an email with confirmation instructions. Click the link included in the email to confirm your account and finish the registration process.
Once you’ve completed these steps, your Filebase account has been created.

Logging into Filebase

1. To login to your Filebase account, navigate to https://filebase.com.
2. At the top right corner of the webpage, select ‘Sign In’. Enter your email address and Filebase password to sign in.
3. Once signed in, you will be brought to the Filebase dashboard.

Filebase Dashboard Navigation

Overview

Overview provides a condensed view of a variety of statistics about your Filebase account. These include the total number of buckets on your account, the total number of objects across those buckets, the total amount of storage used by your account (updated hourly), and the total amount of bandwidth consumed by your account within the last 30 days.

Data Usage

Data Usage refers to the total amount of storage and bandwidth used on your account. The values shown here are daily totals and are the ones used for billing purposes. This data allows you to analyze how your total storage usage and bandwidth usage have changed over the past 30 days.

Recent Activity

Recent Activity shows a history of activity on your account, such as login activity which includes the time and date of logins to your account and the IP address that these logins came from.
On the left side of the screen is the Filebase menu. The menu is broken into three sections: Overview, Data Access, and Your Account.
Overview: Contains the Filebase Dashboard.
Data Access: Contains the Buckets and Access Keys sections.
Your Account: Contains the Settings, Billing, and Support sections.

Data Access

Buckets

The Buckets menu option brings you to the buckets dashboard. From here you can see your existing buckets and create new ones. You can also manage the contents of your existing buckets by uploading or deleting objects inside the buckets.
Buckets are like file folders, they store data and associated metadata
Object Storage uses objects instead of files. Buckets are containers for those objects.

Access Keys

The Access Keys menu option brings you to the access keys dashboard. From here you can view, manage, and rotate your access keys.

Your Account

Settings

In the Settings menu option, you can change the name registered on your Filebase account, as well as change your email address and password.

Billing

From the Billing menu option, you can update your billing information including your credit card information and billing address. You can also view your billing history and receipts for each invoice.

Support

The Support menu option opens your default email client and populates the email recipient address as [email protected]. This is the best way to contact the Filebase team with any questions or concerns about your account or about Filebase.

Creating and Working with Buckets

Creating a Bucket

1. Click on the ‘Buckets’ option from the menu to open the buckets dashboard.
2. Once at the buckets dashboard, create a new bucket by clicking the ‘Create Bucket’ option in the top right corner.
3. Enter a bucket name and choose your storage network.
Bucket names must be unique across all Filebase users, be between 3 and 63 characters long, and can contain only lowercase characters, numbers, and dashes.
Filebase has 3 different decentralized storage networks to choose from:
  • Storj: Private by default. Recommended for larger datasets.
  • Skynet: Public by default. Recommended for easier file sharing.
  • Sia: Private by default. Recommended for data privacy.
Each storage network geo-distributes your data automatically. All data is encrypted at rest and at transit.
4. Once you have filled out these fields, click ‘Create Bucket’.

Emptying a Bucket

1. To empty a bucket of all objects inside of it, start by clicking on the ‘Buckets’ option from the menu to open the buckets dashboard.
2. Once at the buckets dashboard, find the bucket you want to empty the contents of and click the 3 dots on the right side of the screen to toggle the options of the bucket.
3. Select the ‘Empty Bucket’ option.
4. Confirm that you want to empty the bucket by responding to the prompt with the response “permanently delete” in the text input field.
5. Click ‘Empty Bucket’.

Deleting a Bucket

1. To delete a bucket, start by clicking on the ‘Buckets’ option from the menu to open the buckets dashboard.
2. Once at the buckets dashboard, find the bucket you want to delete and click the 3 dots on the right side of the screen to toggle the options of the bucket.
3. Select the ‘Delete’ option.
4. Confirm that you want to delete the bucket by responding to the pop up prompt with the ‘Ok’ option.

Making a Bucket Public or Private

1. To toggle the privacy of a bucket, start by clicking on the ‘Buckets’ option from the menu to open the buckets dashboard.
2. From the buckets dashboard, each bucket on your account will be listed with information including the bucket name, access, storage network, and date created. Under access is an orange toggle icon to toggle between private and public accessibility for each bucket.
Buckets created on the Sia, Storj, and Skynet networks are private by default. However, files stored on the Skynet network and in Skynet buckets include Skylinks, which are public by default.
3. Click the toggle icon to toggle public or private access.

Uploading Objects to a Bucket

1. To upload objects to a bucket, start by clicking on the ‘Buckets’ option from the menu to open the buckets dashboard.
2. Click on the bucket name that you want to upload objects to.
3. After clicking on the bucket name, you will see all objects that are currently in the bucket. To upload more objects to the bucket, click on the ’Upload’ button in the top right corner.
4. Select the files you want to upload to the bucket.

Viewing an Object’s Overview

1. Once an object has been uploaded to a bucket, you can view the object’s overview. Start by clicking on the ‘Buckets’ option from the menu to open the buckets dashboard.
2. Click on the bucket name containing the object you want to view.
3. After clicking on the bucket name, you will see all objects that are currently in the bucket. Click on the object name you want to view.
4. This will open the object’s overview.
From this overview, you can view information on the object such as:
  • Owner: The Filebase user who uploaded the object.
  • Etag: The entity tag of the object.
  • Last Modified: The time and date that the object was last modified.
  • Size: The size of the object in bytes.
  • Key: The name of the object.
  • Object URL: The Filebase object URL. If this object is stored in a public bucket, this link can be used to share the file with others.
  • Object Map: A graphic that shows how many pieces the object has been broken into and a geographical map of where the pieces of this object are located.
  • Object Metadata: Any user-defined metadata on the object will be listed under the Object Metadata header, such as the content-type of the object.

Editing Object Metadata

1. Once an object has been uploaded to a bucket, you can edit the object’s metadata. Start by clicking on the ‘Buckets’ option from the menu to open the buckets dashboard.
2. Click on the bucket name containing the object you want to view.
3. After clicking on the bucket name, you will see all objects that are currently in the bucket. Click on the object name you want to view.
4. This will open the object’s overview. From this overview, you can edit the metadata of the file by selecting the ‘Manage Metadata’ option on the right side of the webpage.
5. This will bring up a Metadata editing page where you can change the content-type and cache-control metadata options for the object, as well as add any additional metadata fields to the object.

Viewing an Object

1. To view the content of an object once uploaded to a bucket, start by clicking on the ‘Buckets’ option from the menu to open the buckets dashboard.
2. Click on the bucket name containing the object you want to view.
3. After clicking on the bucket name, you will see all objects that are currently in the bucket. Click on the object name you want to view.
4. This will open the object’s overview. You can open the file by clicking the ‘Open’ button in the top right corner of the webpage.

Downloading an Object

1. To download an object from a bucket, start by clicking on the ‘Buckets’ option from the menu to open the buckets dashboard.
2. Click on the bucket name containing the object you want to download.
3. After clicking on the bucket name, you will see all objects that are currently in the bucket. Click on the object name you want to download.
4. This will open the object’s overview. You can download the file by clicking the ‘Download’ button in the top right corner of the webpage.

Sharing an Object

1. To share an object from a bucket, start by clicking on the ‘Buckets’ option from the menu to open the buckets dashboard. To share objects using link sharing, the bucket will need to have accessibility set to public.
2. Click on the bucket name containing the object you want to share.
3. After clicking on the bucket name, you will see all objects that are currently in the bucket. Click on the object name you want to share.
4. This will open the object’s overview. You can share the file by clicking the ‘Share’ button in the top right corner of the webpage. This will copy the URL for the object.

Deleting an Object

1. To delete an object from a bucket, start by clicking on the ‘Buckets’ option from the menu to open the buckets dashboard.
2. Click on the bucket name containing the object you want to delete.
3. After clicking on the bucket name, you will see all objects that are currently in the bucket. Find the object that you want to delete and click on the 3 dots on the right side of the screen to toggle the delete option.
4. From the 3 dot toggle options, select the ‘Delete’ option. Confirm you want to delete the object by clicking ‘Ok’ when prompted.

Creating a Folder Inside a Bucket

1. To create a folder for objects inside a bucket, start by clicking on the ‘Buckets’ option from the menu to open the buckets dashboard.
2. Click on the bucket name you want to create a folder inside of.
3. After clicking on the bucket name, select the ‘New Folder’ option in the top right corner of the webpage.
4. Enter the name for the new folder in the prompt and select ‘Create Folder’.

Deleting a Folder Inside a Bucket

1. To delete a folder from a bucket, start by clicking on the ‘Buckets’ option from the menu to open the buckets dashboard.
2. Click on the bucket name containing the folder you want to delete.
3. After clicking on the bucket name, you will see the contents of the bucket. Find the folder that you want to delete and click on the 3 dots on the right side of the screen to toggle the delete option.
Deleting a folder will delete all of its contents as well.
4. From the 3 dot toggle options, select the ‘Delete’ option. Confirm you want to delete the folder by clicking ‘Ok’ when prompted.

Working with Access Keys

Viewing Your Access Keys

1. To view the access key for your Filebase account, start by clicking on the ‘Access Keys’ option from the menu to open the access keys dashboard.
2. Here you can view the access keys for your account. Each access key has two parts, the key and the secret associated with the key. The access key dashboard will also provide information such as the time and date the access key was created on and it’s current status.
3. To use access keys, you will need to have both the key and the secret associated with that key.

Rotating Your Access Key

Rotating an access key will create a new access key and secret access key. Your old key will be disabled and will no longer function.
1. To rotate your access key, start by clicking on the ‘Access Keys’ option from the menu to open the access keys dashboard.
2. Click on the ‘Rotate’ button under the ‘action’ section of the access key dashboard.
3. To confirm the rotation of the access key, respond to the confirmation prompt by inputting the text ‘rotate my keys’ in the text input field.

API endpoint

The Filebase API endpoint is https://s3.filebase.com

Glossary of Terms

Bucket: In object storage, buckets are similar to a traditional file system’s folders. Buckets are containers for objects and the associated metadata of those objects. Unlike traditional file systems, buckets cannot be nested into one another like file folders can be.
Object: In object storage, objects are similar to a traditional file system’s files. They are small entities that contain data and metadata.
Access Key: When accessing Filebase through the S3 API, an access key is required to access your Filebase buckets and objects. Your access key has two components - the key and the secret. You will need both, similar to using a username and password.
Metadata: In object storage, metadata is fully customizable and functional for objects, allowing you to capture application or user specific information for more specific indexing purposes and data management policies.
S3: S3 technology was originally created by Amazon, but it has since become an open standard. Since then, several companies have created their own non-Amazon based version of the API. All references to S3 in this document refer to the S3 API.
Last modified 16d ago