Work with IPFS Storage

🚧

This is a closed beta

If you want to participate, contact [email protected].

Manage your buckets

A bucket is a logical container for organizing and storing your files.

A bucket can contain any number of files. You can also create folders and catalogs within buckets to further organize your data.

Create a bucket

To create a bucket:

1. On the left pane, click IPFS Storage.
2. Click Create bucket.
3. Provide a name. Click Create.

This will create a bucket.

Rename a bucket

To rename a bucket:

1. Navigate to the list of your buckets.
2. Hover over the bucket you want to rename and click the three-dot icon > Edit.
3. Enter a bucket's new name.
4. Click Save.

Delete a bucket

To delete a bucket:

1. Navigate to the list of your buckets.
2. Hover over the bucket you want to delete and click the three-dot icon > Delete.
3. Click Yes, I'm sure.

Manage your folders

Within a bucket, you can optionally create a folder to organize your data. Folders are mutable virtual containers that don't get pinned in the IPFS network and have no CID of their own.

Create a folder

To create a folder:

1. Click Create folder.
2. Provide a name. Click Create.

This will create a folder.

Delete a folder

To delete a folder:

1. Navigate to the folder's location in your bucket.
2. Hover over the folder you want to delete and click the three-dot icon > Delete.
3. Click Yes, I'm sure.

Upload a file

🚧

Upload limit

Current limit per 1 upload is 100MB.

1 upload can contain any kind of objects: single files, multiple files, or a catalog.

You can upload data objects from your local machine or retrieve them directly off the IPFS network.

Upload from your machine

To upload from your machine, within your bucket, click Upload and select one of the following:

• Files — to upload a single file or multiple files. Each of the files will get a separate CID.
• Catalog — to upload a combination of folders and files. The catalog itself and the files in it will get separate CIDs.

This will upload your objects through the Chainstack-hosted IPFS nodes to the Storj network. The file will be automatically pinned.

Upload from the IPFS network

To upload from the IPFS network:

1. In your bucket, click Upload.
2. Select CID.
3. Provide the content identifier of a file that is available on the IPFS network.

This will retrieve the file by its CID off the IPFS network and upload it to the Storj network. The file will be automatically pinned.

Create a dedicated gateway

IPFS dedicated gateways allow for faster and more reliable storage of files in the IPFS network. They have no rate or speed limitation and can be assigned either to a single bucket within an organization or provide access to the whole IPFS network.

To create a dedicated gateway, do the following:

1. Navigate to IPFS Storage > Gateways.
2. Click Create dedicated gateway.
3. Select one of the following gateway modes:
   • Private — to create a gateway that will provide access to a single bucket within your organization.
   • Open — to create a gateway that will provide access to any data objects in the IPFS network.
4. For the private mode, select a bucket to assign a gateway.
5. Enter the Gateway name. This name also will be used as a unique part of the gateway domain.
6. Click Create.

Retrieve your files

You can retrieve your files through a public or dedicated gateway provided by Chainstack or by using the IPFS tooling and your file's CID.

To retrieve through the public or dedicated gateway, on the Chainstack platform, navigate to your file and do one of the following:

• In the Public gateway field, click Copy or Open to get the link to your file through a public gateway.
• In the Dedicated gateway field, click Copy to get the link to your file through a dedicated gateway.

Retrieve using the file's CID:

1. On the Chainstack platform, navigate to your file.
2. In the CID field, click Copy.

This will copy the file's CID that you can use to retrieve the file using IPFS tools.