Storage

Storage mode, license, and Pro are separate

Rabbithole uses several related concepts in the storage flow. They control different parts of the product:

  • Storage mode decides where file bytes live.
  • Storage license defines the base encrypted storage limits.
  • Pro adds extra features for storage you already created.

Storage mode does not replace encryption or access control. File contents are encrypted in the browser before upload, and in both modes the storage canister keeps ownership, access rules, and trusted file records.

The full subscription feature list is on the What Pro gives you page.

Short version

For ordinary files, Blob Storage is usually the better fit: it is cheaper and handles large files more comfortably. Choose On-chain Storage when you want to avoid the external storage layer and cost or file size is not the main constraint.

Two storage modes

Blob Storage Recommended

Blob Storage keeps file bytes in external object storage, while your canister keeps the file record, access rules, and verification data. The external layer sees only encrypted bytes.

  • About $0.05 per GB per month.
  • Best for larger files and lower cost.
  • The file is stored in external object storage.
  • Your personal canister keeps access rules and file verification data.

On-chain Storage Advanced mode

On-chain Storage keeps the file directly inside your personal canister. There are fewer components to trust, but the cost is higher and the cycle balance matters more.

  • About $1.04 per GB per month.
  • Best for small, high-value files.
  • The file is stored directly in your personal canister.
  • There is no dependency on an external storage layer.

Comparison

Blob StorageOn-chain Storage
Best forEveryday storageSpecial scenarios and maximum control
Estimated costAbout $0.05/GB/monthAbout $1.04/GB/month
Where the file livesExternal object storageYour personal canister
What your canister keepsFile record, access rules, verification dataFile record, access rules, file bytes
Upload concernBlob Storage availability and record commitCycle balance and canister safe floor
Trust modelIC + local verification + storage serviceIC + cryptography
About pricing

These are rough estimates for comparison. Real storage cost can change over time.

Integrity and availability are different things

Verification helps detect silent replacement of a file. It does not guarantee that a file will remain available forever. Availability depends on the storage mode, cycle balance, and retention rules of the selected storage service.

What stays the same in both modes

Both modes keep the same user model. The byte location changes; ownership and access keep the same meaning.

  • Your personal canister keeps ownership, access rules, and trusted file records.
  • Encrypted files are encrypted in the browser before upload.
  • The canister checks permissions before file operations and key derivation.
  • Storage license and Pro decide which encrypted uploads are allowed.
  • Integrity verification remains part of the storage path.

What happens if Rabbithole is unavailable?

On-chain Storage: your file remains inside your canister as long as the canister stays funded with cycles.

Blob Storage: your canister still keeps the file record and the information needed to verify the file. File-byte availability depends on Blob Storage funding and retention policy.

Rabbithole is an interface, not the owner of your data

The durable file record lives in your canister. Rabbithole helps you use it and manage service operations, but it does not become the data owner.

Learn more

Understand how storage works

Official Internet Computer references