Filebase
HomepageFilebase DashboardDiscordBlog
  • 👋Welcome to Filebase!
  • Getting Started
    • FAQ
    • Service Limits
    • Getting Started Guides
      • Pin Your First File To IPFS
      • Developer Quick Start Guide
  • IPFS Concepts
    • What is IPFS?
    • What is an IPFS CID?
    • What is IPFS Pinning?
    • What is an IPFS Gateway?
  • IPFS Pinning
    • Pinning Files
    • Listing Files
    • Deleting Files
    • Event Notifications
  • IPNS Names
    • Managing Names
  • Dedicated IPFS Gateways
    • Managing Dedicated Gateways
    • Access Controls
    • Image Optimizations
    • Adding a Custom Domain
  • API Documentation
    • IPFS RPC API
    • S3-Compatible API
      • Cross Origin Resource Sharing (CORS)
        • Create and Apply a CORS Rule to a Filebase Bucket
        • Deep Dive: Cross Origin Resource Sharing (CORS)
      • Pre-Signed URLs
    • Filebase Platform APIs
    • IPFS Pinning Service API
  • Code Development + SDKs
    • Code Development
      • Apache Libcloud - Python
      • Apostrophe CMS
      • AWS Lambda - NodeJS
      • AWS Lambda - Python
      • AWS SDK - Go (Golang)
      • AWS SDK - Java
      • AWS SDK - JavaScript
      • AWS SDK - .NET
      • AWS SDK - PHP
      • AWS SDK - Python
      • AWS SDK - Ruby
      • Code Examples
        • How To Utilize Filebase with NodeJS
      • DataCamp
      • Dart / Flutter
      • Django
      • Docker
        • Docker Volume Backup
      • Elixir Phoenix
      • Filebase NPM Package
      • Fog.io - Ruby
      • Google App Scripts
      • Integrated Haskell Platform
      • Laravel
      • Nuxt
      • Paperspace
      • Postman
      • Reading a JSON File
      • UNA
      • Unity
      • Uppy AWS S3 Plugin
      • Vue
      • Watcher for NodeJS
      • Webpack S3 Plugin
      • Xamarin
    • SDK Examples: Pinning Files and Folders to IPFS
      • AWS SDK for .NET
      • AWS SDK for Go
      • AWS SDK for JavaScript
      • AWS SDK for PHP
      • AWS SDK for Python
      • AWS SDK for Ruby
  • Archive
    • Content Archive
      • IPFS Getting Started Guide
      • Web Console Getting Started Guide
      • IPFS Tools
        • IPFS CLI
        • IPFS Desktop
        • IPFS Pin Sync
        • IPFS Pinning Service API
        • IPFS3up
      • Third Party Tools and Clients
        • Backup Client Configurations
          • AhsayCBS
          • BackupAssist Classic
          • BackupAssist ER
          • BackupNinja
          • BackupSheep
          • Bacula Enterprise Edition
          • CloudBacko
          • CloudBerry Backup
          • Cloudron
          • cPanel
          • Comet
          • Commvault
          • Duplicacy
          • Ghost IPFS Storage Adapter
          • IPFS Pinning GitHub Action
          • JetBackup
          • Kopia
          • MoveBot
          • MSP360 Online Backup
          • oDrive
          • Photos+ Cloud Library
          • qBackup
          • S3 Uploader for GitHub Actions
          • SimpleBackups
          • SnapShooter
          • Strapi Provider Plugin
          • Veeam
          • Wordpress
            • Media Cloud
            • XCloner
          • Zerto
        • CLI Tools
          • Ansible
          • Apache Pulsar
          • AWS CLI
            • How To Delete Data with AWS CLI
            • What is Multipart Upload?
          • Bash
            • Backup Files to IPFS with Bash
            • Laravel Backup with Bash
            • MongoDB Backup with Bash
            • PostgreSQL Backup with Bash
            • Wordpress Backup with Bash
          • cURL
          • Elasticsearch
          • IPFS-CAR
          • IPFScrape
          • IPGet
          • Jenkins
          • JFrog Artifactory
          • Kubernetes
            • Backup and Restore InFluxDB to Filebase with TrilioVault
            • CSI-S3
            • Kasten K10
            • Kerberos Vault
            • Longhorn.io
            • Stash for Kubernetes
            • Velero
          • Litestream
          • Minty
          • MongoDB
          • MoSMB
          • MySQL
          • Next.js .CAR File Upload
          • NFT Image Generator
          • NGINX S3 Gateway
          • Pinning Docker Images to IPFS
          • Pinning Encrypted Files to IPFS
          • PowerShell
            • Calculate the Size of Filebase Buckets using PowerShell
          • Rclone
            • Backing Up DigitalOcean Spaces to Filebase using Rclone
          • Restic
          • S3cmd
          • S3Express
          • S3FS-FUSE
          • S3QL
          • S3Surfer
          • S4cmd
          • SeaweedFS
          • Tableland
        • Content Delivery Networks
          • Bunny CDN
          • CloudFront CDN
          • Fastly CDN
        • File Management Client Configurations
          • Airbyte
          • Arq
          • Astiga
          • AWS Rekognition
          • AWS S3 Manager - iOS App
          • BucketAnywhere for S3 - Android App
          • CentreStack
          • CloudFlyer
          • Cloudfser
          • Couchdrop
          • CrossFTP
          • CyberDuck
            • How To Delete Data with CyberDuck
          • Dropshare
          • Duplicati
          • FileBrowserGO
          • Flexify.IO
          • ForkLift
          • Goofys
          • Joplin
          • LucidLink
          • MASV
          • Matrix Synapse
          • MinIO Gateway for S3
          • Mountain Duck
          • NetDrive
          • Nexfs
          • NextCloud
          • Nodeum
          • ownCloud
          • Plesk
          • Pure Storage FlashBlade
          • RaiDrive
          • S3 Browser
          • ShareX
          • SmartFTP
          • StableBit Cloud Drive
          • Storage Made Easy Enterprise File Fabric
          • WinSCP
        • NAS Device Configurations
          • Buffalo TeraStation
          • Datadobi DobiProtect
          • Netapp ONTAP Select
          • OpenDrives Atlas
          • Synology Hyper Backup
          • TrueNAS CORE
      • Knowledge Base
        • Deep Dives
          • Deep Dive: Blockchains
          • Deep Dive: Decentralized Compute
          • Deep Dive: Decentralized Digital Identity
          • Deep Dive: Decentralized Storage
          • Deep Dive: Erasure Coding
          • Deep Dive: Geo-Redundancy
          • Deep Dive: Metadata
          • Deep Dive: Metaverse
          • Deep Dive: NFTs
          • Deep Dive: Web3
        • Filebase eBooks
        • Filebase One-Pagers
        • Filebase Whitepapers
        • Web3 Tutorials
          • Alchemy
            • Alchemy: Build a dApp That Provides Real-Time Ethereum Transaction Notifications
            • Alchemy: Create a Full-Stack dApp
            • Alchemy: Create a Hello World Smart Contract
            • Alchemy: Create Your Own ERC20 Cryptocurrency
            • Alchemy: Decentralized Youtube
            • Alchemy: How to Create and Mint an NFT using Filebase
            • Alchemy: How to Mint an NFT Using Web3.js
            • Alchemy: Using The Alchemy SDK with NFTs Minted Through thirdweb
          • Agoric
            • Agoric: Create a DeFi dApp Using Agoric That’s Stored on Filebase
          • AirSwap
            • AirSwap: Track NFT Contract Addresses with AirSwap CLI
          • ArcBlock
            • ArcBlock: Running an ArcBlock Blocket Server on IPFS
          • Ankr
            • Ankr: Create a Truffle Project with Ankr and Filebase
            • Ankr: Deploy a Smart Contract on Polygon using Ankr that is backed up to Filebase
          • Avalanche
            • Avalanche: How To Launch a Generative NFT Collection With Avalanche and IPFS
          • Backing Up NFTs
          • Brownie
            • Brownie: Create and Mint an NFT Using Brownie
          • Bueno
            • Bueno: How to Create a Generative NFT Collection with Bueno
          • Cardano
            • Cardano: Submit Cardano Blockchain Transactions with Embedded Metadata Stored on Filebase
          • Ceramic
            • Ceramic: How to Host a Ceramic Node Using Decentralized Storage
          • Create-IPFS-app
          • Cosmos
            • Cosmos: Storing Cosmos Chain Governance Metadata on IPFS
          • DeCommerce
          • Ethereum Name Service
            • ENS: Configure an ENS Domain to use a Filebase IPFS Dedicated Gateway
          • Figment Datahub
            • Figment Datahub and Avalanche: Make an e-Voting dApp Using Figment Datahub, Avalanche, and Filebase
            • Figment Datahub and Celo Network: Create an ERC1155 NFT on the Celo Network using Figment Datahub and Objects Stored on Filebase
          • Flow
            • Flow: How to Create an NFT Marketplace with Filebase + Flow
          • Fauna
            • Fauna: Host an Application on IPFS with IPFS Dedicated Gateways
          • Ganache
            • Ganache: Create a dApp Hosted on IPFS
          • GUN
            • GUN: Create a Decentralized Chat App with GUN and IPFS
          • Hardhat
            • Hardhat: Creating an NFT Contract using Hardhat and Setting NFT Metadata using IPFS on Filebase
          • Harmony
            • Harmony: Deploy an HRC721 NFT on Harmony with IPFS
          • Hosting a Form on IPFS
          • iExec
            • iExec: Using iExec and Tee Worker to Create Apps that Use Datasets Stored on Filebase
          • Infura
            • Infura: Build dApp Frontends with Infura, React, and IPFS
            • Infura: Create an NFT Contract Factory with Metadata stored on IPFS
          • Lens Protocol
            • Lens Protocol: Build a Decentralized Social Media Network Stored on IPFS
          • LIT Protocol
            • LIT Protocol: Create a MintLIT NFT with LIT Protocol and IPFS
          • LivePeer
            • LivePeer: Mint a Video NFT with LivePeer
          • Macrometa
            • Macrometa: Track IPFS Files with Macrometa
          • Mina Protocol
            • Mina Protocol: Create a Simple zkApp with Mina Protocol and IPFS
          • NEAR Protocol
            • NEAR Protocol: Storing Off-Chain Data on IPFS using Filebase
          • NFTPort
            • NFTPort: Create an NFT Collection with NFTPort
          • Ocean Protocol
            • Ocean Protocol: Publish Data NFTs Stored on IPFS using Ocean Protocol
          • Pin Tezos Tokens Tool
          • Polkadot
            • Polkadot: Deploy a Polkadot dApp on Decentralized Storage
          • Polygon
            • Polygon: Building an App NFT With Polygon
            • Polygon: Make a Donation App with IPFS and Polygon
          • Python
            • Generating NFT Metadata with Python
          • QuickNode
            • QuickNode: Create a Token dApp using QuickNode
          • Remix
            • Remix: Create a Web App with Remix to Upload to Decentralized Storage
          • Remix IDE
            • Remix IDE: Creating Interactive NFTs with IPFS and Remix IDE
          • Secret Network
            • Secret Network: Create an NFT on Secret Network with Data Stored on IPFS
          • Stargaze
            • Stargaze: Create an NFT Collection Using IPFS and Stargaze
          • Starknet
            • Starknet: Create a HardHat Project Using A Starknet Plugin Hosted On IPFS
          • Studio 721
            • Studio 721: Create an NFT Collection with Studio 721 and IPFS
          • Solana
            • Solana: Minting an NFT Using Sugar, Candy Machine, and Filebase
          • Subsquid
            • Subsquid: Querying NFT Data using Subsquid and a Filebase IPFS Dedicated Gateway
          • Tailwind CSS
            • Tailwind CSS: Build an Image Gallery App with IPFS and Tailwind CSS
          • Tatum
            • Tatum: How To Mint NFTs on Solana with Tatum
          • Tezos
            • Tezos: Create an NFT on the Tezos Network using IPFS on Filebase
          • thirdweb
            • thirdweb: Build an NFT Loot Box with thirdweb and IPFS
            • thirdweb: Build an NFT Minting Page with thirdweb, IPFS, RainbowKit, and WAGMI
            • thirdweb: Create a Discord Bot That Gives Roles to NFT Holders
            • thirdweb: Create a Gated Website Using NFTs and IPFS
            • thirdweb: Create an NFT Marketplace with thirdweb and IPFS
            • thirdweb: Release an NFT Drop Using thirdweb and IPFS
          • useDApp
            • useDApp: Create a dApp using useDApp and IPFS
          • Unstoppable Domains
            • Unstoppable Domains: Create a Decentralized Website Using Unstoppable Domains and IPFS Folders
            • Unstoppable Domains: Deploy a Decentralized Blog Using Unstoppable Domains, Akash, and IPFS
            • Unstoppable Domains: IPFS Configuration
          • Vultr
            • Vultr: Store Bedrock Minecraft Worlds on Decentralized Storage
            • Vultr: Store Forge Minecraft Worlds on Decentralized Storage
            • Vultr: Store PaperSpigot Minecraft Worlds on Decentralized Storage
            • Vultr: Store Vanilla Minecraft Worlds on Decentralized Storage
          • Waffle
            • Waffle: Deploy a Smart Contract with Waffle That’s Stored on IPFS
          • Walt.id
            • Walt.id: Mint an NFT with Walt.id and Filebase
          • Web3 Toolbox
            • Web3 Toolbox: Building an NFT Drop With Web3 Toolbox
Powered by GitBook
On this page
  • What is Filebase?
  • Common Functions
  • S3 API
  • IPFS Pinning
  • IPFS Dedicated Gateways
  • Integrations
  • Security
  • Use Cases
  • Billing and Pricing
  • Support

Was this helpful?

  1. Getting Started

FAQ

Below you can find frequently asked questions about Filebase.

PreviousWelcome to Filebase!NextService Limits

Last updated 10 months ago

Was this helpful?

Have a question about Filebase? Check out our Frequently Asked Questions below.

What is Filebase?

How does Filebase work?

Filebase is a decentralized, geo-redundant IPFS pinning service that also supports data storage on the Sia network. Filebase operates IPFS nodes located across diverse geographic locations in the US and Europe, and each file uploaded to IPFS is pinned with 3x replication across these servers.

Through either our browser-based interface, using our S3-compatible API, or using the IPFS pinning service API, users can create buckets and pin files to the IPFS network.

What is a bucket?

In the world of object storage, there are buckets and objects. Buckets are like file folders, they store data and the associated metadata. Buckets are containers for objects.

Learn how to create and manage buckets .

What is the difference between a public and private bucket?

Public Buckets can be referenced and accessed through an S3 URL in the following format:

Private buckets cannot be accessed through this S3 URL publicly. To access content stored in Private buckets, a is required.

All files stored in IPFS buckets, even if the bucket is private, are publicly accessible through IPFS CIDs and IPFS gateways. All buckets are private by default.

Public bucket functionality is only available to paid subscription users.

What is an object?

In the world of object storage, objects are files and the associated metadata of those files. Objects get stored in buckets, like in traditional file storage, files get stored in folders.

What are access keys?

Access keys are a pair of unique credentials that are used for authentication through the Filebase S3-compatible API. This access key pair is required for connecting to Filebase through an SDK, third party tool, CLI tool, or any other interaction using the Filebase S3-compatible API.

What does 'Bandwidth' mean?

Bandwidth refers to the amount of data required to display or download the content that you or your users access through the dedicated gateway. Whether it's an image, video, audio, or any other type of file, the data that makes up the content is transmitted from an IPFS node to your device, and the quantity of this data is what determines the bandwidth.

Filebase only charges for Bandwidth for outgoing data transfer (egress). Upload bandwidth (ingress) is always free.

Does Filebase support multiple access key pairs?

Filebase currently does not support multiple access key pairs per account but plans to support this feature in the future.

Common Functions

How do I create a private 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 currently has 2 different decentralized storage networks to choose from:

  • 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’. Buckets are private by default. To create a public bucket, you must be a paid user.

How do I create a public bucket?

Public buckets are not available for free accounts. Users will need to have an active Filebase paid account to create and enable public buckets.

Does Filebase have bucket size limits?

No, there is no maximum size limit for a Filebase bucket, as long as it is within the user's maximum storage allocation based on their subscription tier level.

How do I upload an object?

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.

Does Filebase have object size limits?
If I upload an object with the same name, will it overwrite the original?

Yes, uploading an object with the same name will replace the existing object.

What is the maximum number of objects per bucket?

There is no maximum number of objects that can be stored in a bucket.

What is the maximum storage amount in a single bucket?

There is no maximum storage amount for a single bucket. Maximum storage limits are only imposed on free users, who are limited to a total of 5GB across all buckets. Paid users have no maximum storage limitations.

S3 API

What is the Filebase S3 API rate limit?

The Filebase S3 API has an effective rate limit of 100 RPS (requests per second).

How do I allow other users to upload objects to a bucket on my account?

You can allow others to upload objects to a bucket on your Filebase account through pre-signed URLs.

To create a pre-signed URL with AWS CLI:

aws s3 --endpoint https://s3.filebase.com presign s3://filebase-bucket-name/file.name

How do I use a pre-signed URL?

To create a pre-signed URL with AWS CLI:

aws s3 --endpoint https://s3.filebase.com presign s3://filebase-bucket-name/file.name

What is the maximum object size for an object located in an IPFS bucket?
How do I set a CORS policy on my bucket?

The Filebase S3-compatible API supports CORS configurations for buckets.

The following API methods are supported:

  • GetBucketCors

  • PutBucketCors

  • DeleteBucketCors

To configure a Filebase bucket to allow cross-origin requests, you will need to create a CORS rule. This rule identifies the origins that you will allow to access your bucket, the HTTP methods that will be supported for each origin, and other operation specific information.

This rule can be a JSON or XML file, though if using AWS CLI to apply this rule, a .json file is required.

Example #1 JSON:

This example is a wildcard rule that allows cross-origin GET requests from all origins.

{
"CORSRules":[
    {
        "AllowedHeaders": [],
        "AllowedMethods": [
            "GET"
        ],
        "AllowedOrigins": [
            "*"
        ],
        "ExposeHeaders": []
    }
    ]
}

Example #1 XML:

<CORSConfiguration>
    <CORSRule>
        <AllowedOrigin>*</AllowedOrigin>
        <AllowedMethod>GET</AllowedMethod>
    </CORSRule>
</CORSConfiguration>

Example #2 JSON:

CORS also allows optional configuration parameters, as shown in the following CORS rule.

  • MaxAgeSeconds: Specifies the amount of time in seconds that the browser caches a response to a preflight OPTIONS request for the specified resource.

  • ExposeHeader: Identifies the response headers that customers are able to access from their applications. In this example, x-amz-server-side-encryption, x-amz-request-id, and x-amz-id-2.

In this second example, the CORS rule allows cross-origin PUT, POST, and DELETE requests from the http://www.example.com origin, with a MaxAgeSeconds of 3000 and ExposeHeaders of x-amz-server-side-encryption, x-amz-request-id, and x-amz-id-2.

{
"CORSRules": [
    {
        "AllowedHeaders": [
            "*”
        ],
        "AllowedMethods": [
            "PUT",
            "POST",
            "DELETE"
        ],
        "AllowedOrigins": [
            "http://www.example.com"
        ],
        "ExposeHeaders": [
            "x-amz-server-side-encryption",
            "x-amz-request-id",
            "x-amz-id-2"
        ],
        "MaxAgeSeconds": 3000
    }
    ]
}

Example #2 XML:

<CORSConfiguration>
<CORSRule>
<AllowedOrigin>http://www.example.com</AllowedOrigin>
<AllowedMethod>PUT</AllowedMethod>
<AllowedMethod>POST</AllowedMethod>
<AllowedMethod>DELETE</AllowedMethod>
<AllowedHeader>*</AllowedHeader>
<MaxAgeSeconds>3000</MaxAgeSeconds>
<ExposeHeader>x-amz-server-side-encryption</ExposeHeader>
<ExposeHeader>x-amz-request-id</ExposeHeader>
<ExposeHeader>x-amz-id-2</ExposeHeader>
</CORSRule>
</CORSConfiguration>

Applying a CORS Rule to a Filebase Bucket

From the command line, enter the following command to apply the CORS rule to the intended Filebase bucket:

aws --endpoint https://s3.filebase.com s3api put-bucket-cors --bucket bucket-name --cors-configuration=file://corspolicy.json

IPFS Pinning

How do I pin an object to IPFS?

All files uploaded to IPFS are pinned to IPFS automatically. This means that they are protected from the IPFS garbage collection process. 1. Start by clicking on the ‘Buckets’ option from the menu to open the Buckets dashboard.

2. Select your IPFS Bucket.

3. After clicking on the bucket name, you will see any previously uploaded files. To upload another file, select 'Upload', then select 'File' from the options.

4. Select the file you want to upload to the IPFS.

5. Once uploaded, you will be able to view and copy the IPFS CID from the 'CID' category.

How do I pin a folder to IPFS?

1. Start by clicking on the ‘Buckets’ option from the menu to open the Buckets dashboard.

2. Select your IPFS Bucket.

3. After clicking on the bucket name, you will see any previously uploaded files. To upload another file, select 'Upload', then select 'Folder' from the options.

4. Select the folder you'd like to upload to IPFS.

5. Once uploaded, the folder will look similar to IPFS individual files.

6. Copy the IPFS CID for your folder, then navigate to https://ipfs.filebase.io/ipfs/[CID]. The contents of your folder will be listed.

Is data uploaded to IPFS public?

Yes, all data uploaded to IPFS is public, even if the data is stored in a private Filebase bucket. All data uploaded to IPFS can be referenced and accessed by their IPFS CID through an IPFS gateway.

What does Pinned 3x mean?

Filebase operates a unique IPFS architecture that is specifically designed to maximize performance, availability, and content discoverability.

When you uploaded a file to Filebase, the file is automatically replicated to 3 unique data centers and pinned to IPFS by each of them. Each data center is geographically separated and resides in a different country or continent.

The net result is 3 unique IPFS peers are now pinning the same file, and with IPFS, performance, availability, and discoverability all increase with peer count.

How do I use an IPFS gateway?

Content stored on IPFS can be accessed by using an IPFS gateway. Gateways are used to provide workarounds for applications that don’t natively support IPFS. An IPFS gateway can be local, private, or public, and uses the IPFS content ID to provide a URL link to the content for access to the stored content.

Filebase's native IPFS gateway is as follows: https://ipfs.filebase.io/ipfs/{CID}

The Filebase Public IPFS Gateway has an effective rate limit of 200 RPM (requests per minute).

All content stored on IPFS through Filebase can be accessed through the Filebase gateway with faster response times than accessing the content through any other gateway. This is because the Filebase gateway is peered with our IPFS nodes. The Filebase gateway is also peered with the IPFS gateways of other pinning services.

What is the Filebase IPFS public gateway rate limit?

The Filebase Public IPFS Gateway has an effective rate limit of 200 RPM (requests per minute).

Will my files stay on IPFS if I cancel my account?

Your files will persist on IPFS if they’re being cached by other nodes. However, over time they may become unresponsive if those nodes remove your files through the garbage collection process. Additionally, there is no guarantee that other nodes are caching your files to begin with.

IPFS Dedicated Gateways

What is an IPFS dedicated gateway?

An IPFS gateway is an IPFS peer that accepts HTTP requests for IPFS CIDs. A dedicated gateway provides users with a convenient way to access IPFS content without needing to run an IPFS node themselves. The gateway acts as an intermediary between the user's web browser or application and the IPFS network, retrieving and serving content on behalf of the user.

For a deep dive on IPFS gateways and how they work, plus a full walkthrough of using IPFS gateways on Filebase, see our documentation here.

What are the benefits of using an IPFS dedicated gateway?

Dedicated Gateways come with several benefits, such as:

  • Increased performance and retrieval times.

  • No rate limits when accessing content through the dedicated gateway.

  • Limiting content (whitelisting) that the gateway can serve through the Scope feature of a dedicated gateway.

  • Setting a Root CID of the gateway that can be used for website or app hosting.

Do you have any examples on how to use IPFS dedicated gateways?

Yes! We have several tutorials in the IPFS Gateways section of our documentation.

Integrations

What API clients or tools work with Filebase?

Since Filebase is S3-compatible, it works out of the box with S3 API compatible tools, SDKs, and frameworks. For a full list of tools that we have documentation on, please see our documentation for the following:

Security

I’ve read a lot about AWS S3 Buckets leaking data - How secure is Filebase by default?

Data stored on Filebase is always encrypted during transit and when the data is at rest. Server-side encryption is native and by default enabled for all users.

Since Filebase supports decentralized networks powered by blockchain, objects are stored in small chunks across multiple nodes around the world. No node ever has complete access to an entire object or unencrypted data.

In an effort to further simplify security and access control, objects on the Filebase platform inherit the ACL of the parent bucket. For example, the GetObjectAcl and GetBucketAcl methods will function as expected, but the GetObjectAcl response will return the ACL of the bucket that the object is contained in.

The Filebase S3-compatible API supports HTTP/2 (which requires TLS) and data encryption at rest. Data encryption at rest is enabled by default without any additional action required by the user.

Use Cases

How does Filebase help my Disaster Recovery (DR) strategy?

Filebase is pioneering the concept of "native geo-redundancy" for IPFS Pinning and data storage. Native geo-redundancy by default provides Filebase users a default level of 3x redundancy for all of their data, within one single bucket on the Filebase platform. In order to accomplish the same level of redundancy with AWS, you would need 3 regionally-distributed buckets, at 3 times the cost.

Can I use Filebase for my NFT collection?
Can I use Filebase for decentralized application (dApp) storage?
Can I use Filebase for personal data storage?

Yes, Filebase can be used for personal data storage. Filebase can be configured for use with hundreds of different backup tools, NAS devices, and file management applications. Check out our documentation on third party configurations here.

Is Filebase an alternative for AWS?
Is Filebase an alternative for Pinata?

Billing and Pricing

How much is pricing on Filebase?

Please review our Pricing Model for more information about our current storage pricing on Filebase.

How do I start a free trial?
What is the bandwidth limit for a free user?

Free users are limited to 5GB of egress bandwidth.

How do I upgrade to a paid subscription?

Upgrading to a Paid Subscription

2. Select the subscription plan that fits your workflow. For detailed information on each pricing plan, please see our Pricing Model.

3. Once you select a plan, you will be redirected to a Stripe checkout screen. Enter your billing information and confirm your subscription by selecting 'Subscribe'.

The Stripe checkout will detail 3 parts:

  • Your base subscription plan: In this example, the IPFS Starter Plan is used.

  • IPFS Storage: This refers to any storage used that is over the selected plan's included storage. For the IPFS Starter Plan, this is any storage over 200GB.

  • IPFS Bandwidth: This refers to any bandwidth used that is over the selected plan's included bandwidth. For the IPFS Starter Plan, this is any bandwidth over 400GB.

For detailed information on the included values for each subscription plan, please see our Pricing Model.

How do I change a payment method?

Changing a Payment Method

2. You will be redirected to a Stripe webpage to enter your new payment information.

3. Click 'Save Card'.

Does Filebase accept crypto payments?

Filebase does not currently accept payment in cryptocurrencies.

Does Filebase have a minimum monthly charge?

Filebase's minimum monthly charge for IPFS paid subscriptions is $20 per month.

What's Included:

Data Storage:

  • 200 GB IPFS Storage. Additional storage over 200 GB is billed @ $0.15/GB.

  • Unlimited Number of Pinned Files

Bandwidth:

  • 400 GB of egress bandwidth. Additional Bandwidth is billed @ $0.015/GB.

Additional Features:

  • 1 Dedicated IPFS Gateway

  • IPFS Pinning Service API

  • S3-Compatible API

  • Unlimited API Requests

  • Unlimited Filebase Public Gateway Bandwidth

Filebase's minimum monthly charge for storage on the Sia network only is $5.99, which includes the first 1 TB of storage and 1 TB of bandwidth.

How is storage usage calculated?

Filebase storage usage is calculated in binary gigabytes (GB), where 1GB is 2³⁰ bytes. This unit of measurement is also known as a gibibyte (GiB), defined by the International Electrotechnical Commission (IEC). Similarly, 1TB is 2⁴⁰ bytes, i.e. 1024 GBs.

How are my usage charges calculated?

Storage Usage Charges: Calculated on the amount of active storage that is stored with Filebase for the billing cycle.

Bandwidth Usage Charges: Amount of data (object data only) that leaves (egresses) the Filebase platform.

Billing Periods: Filebase bills on a 30-day cycle, regardless of the length of the month or when the billing cycle starts.

Are there pricing discounts for customers with large amounts of data storage?
How do I remove a payment method?

Once a payment method is added, it cannot be removed. A new payment method can be added to replace the pre-existing payment method, but a payment method must be on file once you have selected a paid subscription plan.

How do I downgrade to a different paid subscription tier?

Downgrading a Subscription

To downgrade your account to a different paid tier, simply select the tier you'd like to downgrade to and confirm the transaction through the Stripe checkout screen.

If you are using storage or bandwidth over the included amount in the tier you are downgrading to, please note that you will be charged an overage charge for the amount of storage and bandwidth used that is over the amount included in your new subscription tier.

How do I cancel my paid subscription?

Canceling a Paid Subscription

Canceling your paid subscription is simple. To start, your account must be using 5 GB or less to fit within our free tier. You will not be able to downgrade until your account is consuming 5GB or less. Then, follow these easy steps:

  1. Select the Downgrade to Free button under the Free subscription tier.

How do I close my Filebase account?

Due to the nature of our service (data storage), customers must clean up and remove all of their data first before closing their account. This can be done from within our console dashboard or using our API, though the API is the recommended workflow.

We only allow 1,000 files to be deleted at a time from our browser dashboard. Depending on the number of files that you have, you can click Delete and wait a few minutes, or you can use an API client such as CyberDuck or AWS CLI to delete your data.

Support

How do I request a feature?
How do I report a bug?
Where can I submit a help desk ticket?
Does Filebase have a community Discord server?
Does Filebase have an SLA?

Filebase does not have a formal SLA.

Where can I find the Filebase Acceptable Use Policy (AUP)?

Files stored on IPFS are publicly accessible through IPFS gateways. Recommended for storing data related to Web3 assets, such as NFTs, metadata, or decentralized website data.

Filebase object size limits vary based on network. IPFS: IPFS does not have a maximum file size, but any file larger than 5GB should be uploaded using the to benefit from Multipart Upload.

Sia: The largest individual object size supported for objects stored in Sia buckets is 300GB. The largest object that can be uploaded in a single HTTP PUT or POST is 5GB. If you want to upload an object larger than 5GB, you will need to initiate a via our S3 API.

For objects larger than 100MB, customers should consider using the capability for increased reliability.

Learn more about multipart uploads

If you haven't used AWS CLI before, see for our guide on configuring and getting started using AWS CLI.

For more information on pre-signed URLs, check out our documentation

If you haven't used AWS CLI before, see for our guide on configuring and getting started using AWS CLI.

For more information on pre-signed URLs, check out our documentation

Files up to 1 TB in size are supported. However, we strongly encourage users to keep file sizes to 250 GB or below, as working with larger files can introduce additional challenges. Any file larger than 5GB should be uploaded using the Multipart Upload API.

To apply a CORS rule, you can use a tool such as the AWS CLI to apply the .json file you created containing the rule. For information on how to configure AWS CLI, see .

This makes Filebase an ideal platform for developers with valuable data or larger companies and enterprises focused on disaster recovery. To learn more about geo-redundancy, check out our Deep Dive .

Yes, Filebase can be used in a variety of different NFT collection workflows. Check out our for detailed walkthroughs on how to use Filebase in different NFT collection smart contracts and workflows.

Yes, Filebase can be used in a variety of different dApp workflows. Check out our for detailed walkthroughs on how to use Filebase in dApp configurations.

Yes, Filebase offers an S3-compatible API that can be configured as an alternative to most S3-compatible tools and applications as an alternative to AWS. Read more about our S3 API

Yes, Filebase offers an IPFS pinning service that can be used as an alternative to the Pinata IPFS pinning service. Read more about our IPFS pinning service .

Once you create a Filebase account, your account will be a free user by default. Filebase is , who can store up to 5GB of data on Filebase with no credit card required. After 5GB, users will need to upgrade to our subscription model.

Visit the of the dashboard. Subscriptions are split between the IPFS network and the Sia network. The IPFS Pricing Plans will be shown first, followed by the Decentralized Storage Pricing Plan for the Sia network.

4. Once subscribed, your current payment method will be listed under 'Payment Method' on the Web Console page.

Visit the of the dashboard. Select 'Edit' next to your currently listed payment method.

Please email for more information.

Visit the page of the dashboard.​

Once all data has been cleaned up, you will need to email to submit a written request to close your account.

You can request a feature by joining our , or sending us an email at .

You can report a bug by joining our , or sending us an email at .

You can submit a help desk ticket by sending us an email at .

You can join our community Discord server by clicking

The Filebase Acceptable Use Policy can be found

IPFS:
Multipart Upload
Multipart Upload
here.
here
here.
here
here.
here
CLI Tools
Code Development
Backup Client Configurations
Content Delivery Networks
File Management Client Configurations
NAS Device Configurations
here
Web3 tutorials
Web3 tutorials
here.
here
free to use for all users
Billing page
Billing
Billing page
hello@filebase.com
Billing
hello@filebase.com
Discord server
hello@filebase.com
Discord server
hello@filebase.com
hello@filebase.com
here.
here.
https://bucket-name.s3.filebase.com
pre-signed URL
S3-compatible API
S3-compatible
here