sharey/STORAGE_QUICKSTART.md

🚀 Storage Quick Start

Just want to get started quickly? Here's how to choose your storage type:

📁 Local Storage (Easiest)

Best for: Development, testing, small self-hosted setups

1. Edit config.json:

{
  "storage": {
    "backend": "local"
  }
}

2. Test it:

python test_storage.py

3. Done! Files will be stored in the storage/ folder.

☁️ Cloud Storage (B2)

Best for: Production, scaling, reliability

1. Get B2 credentials:

   • Sign up at backblaze.com
   • Create a bucket
   • Create application key

2. Edit config.json:

{
  "storage": {
    "backend": "b2"
  },
  "b2": {
    "application_key_id": "your_key_id",
    "application_key": "your_application_key",
    "bucket_name": "your_bucket_name"
  }
}

3. Test it:

python test_storage.py

4. Done! Files will be stored in your B2 bucket.

🔄 Switch Anytime

Want to switch? Just change the "backend" field:

{
  "storage": {
    "backend": "local"    // or "b2"
  }
}

Then run python test_storage.py to verify.

🆘 Need Help?

• Validation errors? Run python src/config_util.py validate
• Want interactive setup? Run python src/config_util.py set
• Full documentation: See docs/STORAGE.md