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:
- On the left pane, click IPFS Storage.
- Click Create bucket.
- Provide a name. Click Create.
This will create a bucket.
Rename a bucket
To rename a bucket:
- Navigate to the list of your buckets.
- Hover over the bucket you want to rename and click the three-dot icon > Edit.
- Enter a bucket's new name.
- Click Save.
Delete a bucket
To delete a bucket:
- Navigate to the list of your buckets.
- Hover over the bucket you want to delete and click the three-dot icon > Delete.
- 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:
- Click Create folder.
- Provide a name. Click Create.
This will create a folder.
Delete a folder
To delete a folder:
- Navigate to the folder's location in your bucket.
- Hover over the folder you want to delete and click the three-dot icon > Delete.
- 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:
- In your bucket, click Upload.
- Select CID.
- 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:
- Navigate to IPFS Storage > Gateways.
- Click Create dedicated gateway.
- 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.
- For the private mode, select a bucket to assign a gateway.
- Enter the Gateway name. This name also will be used as a unique part of the gateway domain.
- 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:
- On the Chainstack platform, navigate to your file.
- In the CID field, click Copy.
This will copy the file's CID that you can use to retrieve the file using IPFS tools.
Updated 10 months ago