# Pin Your First File To IPFS

Start by [signing up](https://filebase.com/signup) for a Filebase account, then [logging into](https://console.filebase.com) the Filebase dashboard. 

## Create An IPFS Bucket

Simply navigate to your [Dashboard Console](https://console.filebase.com/), create a new bucket and choose the IPFS option.

![](https://3861818989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lyjw7dWpiQtUFDa1pO0%2Fuploads%2FHfX1vTwGNPUfBYWmdIxX%2Fimage.png?alt=media\&token=e00b70ef-0abc-464e-ac73-bb8b0ff742ab)

<figure><img src="https://3861818989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lyjw7dWpiQtUFDa1pO0%2Fuploads%2FPqn5KiQGdrkmFKBLzncK%2Fipfs-bucket.png?alt=media&#x26;token=5509fbe5-0fd5-4cfb-b963-d15d3afe5154" alt=""><figcaption></figcaption></figure>

After clicking on the bucket name, select **Upload** in the top right corner. You will have three options:

* **File:** File is for uploading an individual file to IPFS. This can be an image, video, audio, text, or any other file type.&#x20;
* **Folder:** Folder is for uploading a folder containing multiple files, such as an NFT collection, or the files for a static website.&#x20;
* **CID:** CID stands for [content identifier](https://docs.filebase.com/ipfs-concepts/what-is-an-ipfs-cid), and is for re-pinning an existing IPFS CID that you may have from another pinning provider or a local IPFS node.&#x20;

![](https://3861818989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lyjw7dWpiQtUFDa1pO0%2Fuploads%2FpCsS1zp2iYXCVY1EaIvD%2FScreen%20Shot%202022-08-19%20at%204.25.02%20PM.png?alt=media\&token=b24330e3-2097-46c6-b57a-cdb3b59740ea)

To upload a single file, choose **File**, then when prompted select the file you want to upload to IPFS.

Once uploaded, confirm that that status reads **pinned**. You will then be able to view and copy the IPFS CID from the **CID** category, as seen below.

![](https://3861818989-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lyjw7dWpiQtUFDa1pO0%2Fuploads%2FEr6oLgbNU254oIgmLaM4%2FScreen%20Shot%202022-08-19%20at%204.27.38%20PM.png?alt=media\&token=a7da16bc-2b1c-43e8-be6b-8e052aa25bce)

### Want to learn more?

{% content-ref url="../../ipfs-concepts/what-is-an-ipfs-cid" %}
[what-is-an-ipfs-cid](https://docs.filebase.com/ipfs-concepts/what-is-an-ipfs-cid)
{% endcontent-ref %}

{% content-ref url="../../ipfs-concepts/what-is-an-ipfs-gateway" %}
[what-is-an-ipfs-gateway](https://docs.filebase.com/ipfs-concepts/what-is-an-ipfs-gateway)
{% endcontent-ref %}

{% content-ref url="../../ipfs-concepts/what-is-ipfs-pinning" %}
[what-is-ipfs-pinning](https://docs.filebase.com/ipfs-concepts/what-is-ipfs-pinning)
{% endcontent-ref %}

{% content-ref url="../../api-documentation/ipfs-pinning-service-api" %}
[ipfs-pinning-service-api](https://docs.filebase.com/api-documentation/ipfs-pinning-service-api)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.filebase.com/getting-started/getting-started-guides/pin-your-first-file-to-ipfs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.