Skip to main content
Paperclip stores uploaded files (issue attachments, images) using a configurable storage provider.

Local Disk (Default)

Files are stored at:
~/.paperclip/instances/default/data/storage
No configuration required. Suitable for local development and single-machine deployments.

S3-Compatible Storage

For production or multi-node deployments, use S3-compatible object storage (AWS S3, MinIO, Cloudflare R2, etc.). Configure via CLI:
pnpm paperclipai configure --section storage

Configuration

ProviderBest For
local_diskLocal development, single-machine deployments
s3Production, multi-node, cloud deployments
Storage configuration is stored in the instance config file:
~/.paperclip/instances/default/config.json