> For the complete documentation index, see [llms.txt](https://eth-limo.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eth-limo.gitbook.io/documentation/ipfs-pinning-providers/filebase/filebase-ipfs-pinning.md).

# Filebase IPFS Pinning

New to pinning? See [What is IPFS Pinning?](/documentation/ipfs/what-is-ipfs-pinning.md) for the concepts — garbage collection, why pinning is required, and when to use a pinning service.

### How To Pin New Data on IPFS With Filebase <a href="#how-to-pin-new-data-on-ipfs-with-filebase" id="how-to-pin-new-data-on-ipfs-with-filebase"></a>

Files uploaded to an IPFS bucket on Filebase are *automatically* pinned to IPFS and stored with **3x** **replication** across the Filebase infrastructure by default, at no extra cost to you. This means your data is accessible and reliable in the event of a disaster or outage, and won't be affected by the IPFS garbage collection process.

#### Uploading a File to IPFS Through The Filebase Web Dashboard <a href="#uploading-a-file-to-ipfs-through-the-filebase-web-dashboard" id="uploading-a-file-to-ipfs-through-the-filebase-web-dashboard"></a>

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

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-8e61bd47c38e97c892a5707fcecf7dfa20869491%2Ffilebase-01.png?alt=media" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-573dff95e7e40ba08d7adf8681b942364fd22d5e%2Ffilebase-02.png?alt=media" alt=""><figcaption></figcaption></figure>

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, as seen below.

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-58ab57b9b8fe42ec1ed815c314338340a9da10cb%2Ffilebase-03.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Uploading a Folder to IPFS Through The Filebase Web Console <a href="#uploading-a-folder-to-ipfs-through-the-filebase-web-console" id="uploading-a-folder-to-ipfs-through-the-filebase-web-console"></a>

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

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-8e61bd47c38e97c892a5707fcecf7dfa20869491%2Ffilebase-01.png?alt=media" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-89fce88afc0912620a7e8b45a2d4426ba3c2b232%2Ffilebase-04.png?alt=media" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-c01853e4d582c57b938dfc96b8b3d15e32cc5858%2Ffilebase-05.png?alt=media" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-d9743ef9a3513fdd7fd3c7b343934eddcbe352dd%2Ffilebase-06.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Uploading a File to IPFS Using the S3-Compatible API <a href="#uploading-a-file-to-ipfs-using-the-s3-compatible-api" id="uploading-a-file-to-ipfs-using-the-s3-compatible-api"></a>

If you're using the S3 compatible API, the CID will be returned in the response of a PutObject call.

For example, if we run the following AWS CLI command:

`aws --endpoint https://s3.filebase.com s3 cp test-images/7FIMFhlMf6A.jpg s3://ipfs-test --debug`

For more information on AWS CLI, see [here.](https://docs.filebase.com/third-party-tools-and-clients/cli-tools/aws-cli)

The response is shown below. For convenience, we've highlighted the respective response header:

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-a189ce1ffc8a1a40dc9b04518840b5f8c6e9fc6a%2Ffilebase-07.png?alt=media" alt=""><figcaption></figcaption></figure>

You can also call the HeadObject API to fetch the CID at any time as well:

`aws --endpoint https://s3.filebase.com s3api head-object --bucket ipfs-test --key 7FIMFhlMf6A.jpg`

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-53f46a348faed1f7a6f3790cc551db02e9f4c267%2Ffilebase-08.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Uploading a Folder to IPFS Using IPFS Desktop then Pinning it Using Filebase <a href="#uploading-a-folder-to-ipfs-using-ipfs-desktop-then-pinning-it-using-filebase" id="uploading-a-folder-to-ipfs-using-ipfs-desktop-then-pinning-it-using-filebase"></a>

1. Start by downloading the [IPFS Desktop GUI client](https://github.com/ipfs/ipfs-desktop/releases), or navigating to the [IPFS Web UI.](https://github.com/ipfs/ipfs-webui)
2. Select 'Files' from the left side bar menu.

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-a3188a72ba2faad305d4c60eb29cfaaf5c4e24ad%2Ffilebase-09.png?alt=media" alt=""><figcaption></figcaption></figure>

1. Select 'Import'

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-68f79d1c5074b91dd84c727ca03f96257cb25606%2Ffilebase-10.png?alt=media" alt=""><figcaption></figcaption></figure>

1. Select 'Folder' from the list of options.

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-ffb02d6cb9ef70abfaaacce3b26c8f1db0a522ec%2Ffilebase-11.png?alt=media" alt=""><figcaption></figcaption></figure>

1. Select the folder you'd like to upload. Once it has been imported into IPFS Desktop, select the three dots to the right of the screen.

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-002236478279ef527261b9351389a629b0d57896%2Ffilebase-12.png?alt=media" alt=""><figcaption></figcaption></figure>

1. From the list of options, select 'Copy CID'.

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-56a6a59e05d95af8afad4cd7459df4b330822070%2Ffilebase-13.png?alt=media" alt=""><figcaption></figcaption></figure>

1. Next, navigate to the [Filebase Web Console dashboard](https://console.filebase.com/). Click on the ‘Buckets’ option from the menu to open the Buckets dashboard.

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-3554dec402b579a5b108bd88b12e7fe8d743872e%2Ffilebase-14.png?alt=media" alt=""><figcaption></figcaption></figure>

8\. Once at the Buckets dashboard, create a new IPFS bucket by clicking the ‘Create Bucket’ option in the top right corner.

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-00df4ed44458cd818cacf5589565ef4fe21ff8f8%2Ffilebase-15.png?alt=media" alt=""><figcaption></figcaption></figure>

9\. Enter a bucket name and choose the IPFS 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.*

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-a017466981e05b442c89fd8614fdb59402d00a4d%2Ffilebase-16.png?alt=media" alt=""><figcaption></figcaption></figure>

10\. Then select your new IPFS Bucket.

11\. After clicking on the bucket name, select 'Upload' from the top right corner, then select 'CID'.

Pin by CID is a paid feature that requires a paid Filebase IPFS subscription plan.

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-4eb34cc8fa4976dda03f748180f0b9508ca5d61f%2Ffilebase-17.png?alt=media" alt=""><figcaption></figcaption></figure>

12\. Then enter your IPFS CID that you copied from IPFS Desktop and a custom human-readable name to associate with your CID.

<figure><img src="https://3012111568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn4PkwKyPvID2082agde0%2Fuploads%2Fgit-blob-82b7b7326f109c22069d9c8da26933695faaa357%2Ffilebase-18.png?alt=media" alt=""><figcaption></figcaption></figure>

13\. Select 'Search and Pin' to pin your CID to IPFS through Filebase.

**Note:** The IPFS network is large and it may take some time for Filebase's IPFS nodes to locate and fetch the CID.