---
title: Storage
summary: Local disk vs S3-compatible storage
---

Paperclip stores uploaded files (issue attachments, images) using a configurable storage provider.
New run logs and explicitly requested provider traces reuse the same settings.
S3 instances store these under `run-logs/` and `provider-traces/` within the
existing prefix. Local-disk instances keep them local.

## 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:

```sh
pnpm paperclipai configure --section storage
```

## Configuration

| Provider | Best For |
|----------|----------|
| `local_disk` | Local development, single-machine deployments |
| `s3` | Production, multi-node, cloud deployments |

Storage configuration is stored in the instance config file:

```
~/.paperclip/instances/default/config.json
```