Pinning allows you to persist and make streams available on a Ceramic node beyond a single session. This guide demonstrates how to add and remove streams from your node's pinset, and how to list the streams currently in the pinset. In order to interact with a pinset, you must have installed a Ceramic client.
By default Ceramic will garbage collect any stream that has been written or queried on your node after some period of time. In order to prevent the loss of streams due to garbage collection, you need to explicitly pin the streams that you wish to persist. Pinning instructs the node to keep them around in persistent storage until they are explicitly unpinned. To learn more about Ceramic's data persistence and availability model, see Data Availability.
Add to pinset¶
pin.add() method to add a stream to your permanent pinset.
const streamId = 'kjzl6cwe1jw14...' await ceramic.pin.add(streamId)
Remove from pinset¶
pin.rm() method to remove a stream from your permanent pinset.
const streamId = 'kjzl6cwe1jw14...' await ceramic.pin.rm(streamId)
List streams in pinset¶
pin.ls() method to list streams currently in your permanent pinset.
const streamIds = await ceramic.pin.ls()