Buckets

ICBucket

ICPay Cloud guide

On-chain encrypted file storage

New bucketPricingGitLab
HomeIntroductionQuick StartInstallationConfigurationAuthenticationBasic UsageBest PracticesAPI OverviewAPI EndpointsAPI RequestsAPI ResponsesError CodesError HandlingTroubleshootingLocal DevelopmentProduction DeploymentConfiguration ReferenceTypes ReferenceChangelogFrequently Asked Questions
ICBucket

On-chain encrypted file storage

Overview

IntroductionQuick StartInstallation

Guides

ConfigurationAuthenticationBasic UsageBest Practices

API Reference

API OverviewAPI EndpointsAPI RequestsAPI Responses

Errors

Error CodesError HandlingTroubleshooting

Deployment

Local DevelopmentProduction Deployment

Reference

Configuration ReferenceTypes ReferenceChangelog

FAQ

Frequently Asked Questions
ICPay

© 2026 ICPay. All rights reserved.

contact@icpay.cloud

Products

  • ICFalcon
  • ICBucket
  • Canisters
  • Top up cycles
  • ICPay Wallet

Explore

  • Channels
  • Blog

Resources

  • Falcon CLI
  • ICP-Hub Packages
  • ICBucket Docs
  • Blog

Company

  • Charity
  • About
  • FAQ
  • Roadmap

Legal

  • Brands
  • Terms
  • Privacy
  • Transparency

Community

  • GitLab
  • X
  • LinkedIn
  • Discord
  • Support
ICPayICPay
  • Blog
Buckets

ICBucket

ICPay Cloud guide

On-chain encrypted file storage

New bucketPricingGitLab
HomeIntroductionQuick StartInstallationConfigurationAuthenticationBasic UsageBest PracticesAPI OverviewAPI EndpointsAPI RequestsAPI ResponsesError CodesError HandlingTroubleshootingLocal DevelopmentProduction DeploymentConfiguration ReferenceTypes ReferenceChangelogFrequently Asked Questions
ICBucket

On-chain encrypted file storage

Overview

IntroductionQuick StartInstallation

Guides

ConfigurationAuthenticationBasic UsageBest Practices

API Reference

API OverviewAPI EndpointsAPI RequestsAPI Responses

Errors

Error CodesError HandlingTroubleshooting

Deployment

Local DevelopmentProduction Deployment

Reference

Configuration ReferenceTypes ReferenceChangelog

FAQ

Frequently Asked Questions

ICBucket Documentation

Decentralized on-chain cloud storage on the Internet Computer with multi-region Edge CDN delivery.

ICBucket Documentation

Welcome to the official developer documentation for ICBucket, the enterprise decentralized object storage system built natively on the Internet Computer (ICP). ICBucket enables developers to store, retrieve, encrypt, and stream static assets, backups, media, and NFT metadata entirely on-chain — with automatic Edge CDN acceleration via https://cdn.icpay.app/cloud/.

Prerequisites

Before starting, ensure you have:

  • An active ICPay account with Internet Identity login.
  • An ICBucket created via the ICPay Bucket Dashboard or via CLI.
  • A generated Read/Write API key or your Internet Identity delegation.

Core Pillars

  • Zero AWS Egress Fees: Store permanently on-chain without monthly credit card bill surprises.
  • Global Edge CDN: Files are served through https://cdn.icpay.app/cloud/{bucketName}/{filePath} with sub-50ms cache hits.
  • Multi-Language SDKs: Native clients for TypeScript/Node.js, Python, Rust, and Go.
  • Autonomous & Censorship-Resistant: Powered by Motoko smart contracts with 100% on-chain integrity verification.

Getting Started

Follow the task-oriented documentation sections below to get up and running:

Introduction

Decentralized on-chain storage, architecture, and comparison with AWS S3 & IPFS.

Quick Start

Install icpay-bucket and upload your first decentralized file in under 5 minutes.

Installation & CLI

Ecosystem package managers (npm, pip, cargo, go) and developer CLI installer.

Configuration

Client options, environment variables, timeout parameters, and Edge CDN routing.

Basic Usage

File uploads, chunking, folder listings, pagination, and deletion.

API Endpoints

Comprehensive REST endpoints and Canister RPC actor methods with interactive examples.

Error Handling

Status codes, retry mechanisms, exponential backoff, and network error resolution.

Frequently Asked Questions

Pricing, cycles billing, file durability, security, and custom domains.

Related Pages

  • Introduction
  • Quick Start
  • Installation
  • API Reference

On this page

PrerequisitesCore PillarsGetting StartedRelated Pages
HomeIntroductionQuick StartInstallationConfigurationAuthenticationBasic UsageBest PracticesAPI OverviewAPI EndpointsAPI RequestsAPI ResponsesError CodesError HandlingTroubleshootingLocal DevelopmentProduction DeploymentConfiguration ReferenceTypes ReferenceChangelogFrequently Asked Questions
HomeIntroductionQuick StartInstallationConfigurationAuthenticationBasic UsageBest PracticesAPI OverviewAPI EndpointsAPI RequestsAPI ResponsesError CodesError HandlingTroubleshootingLocal DevelopmentProduction DeploymentConfiguration ReferenceTypes ReferenceChangelogFrequently Asked Questions
ICBucket

On-chain encrypted file storage

Overview

IntroductionQuick StartInstallation

Guides

ConfigurationAuthenticationBasic UsageBest Practices

API Reference

API OverviewAPI EndpointsAPI RequestsAPI Responses

Errors

Error CodesError HandlingTroubleshooting

Deployment

Local DevelopmentProduction Deployment

Reference

Configuration ReferenceTypes ReferenceChangelog

FAQ

Frequently Asked Questions