Configuring File Storage for a Tenant

Set up per-tenant file storage: UploadThing, AWS S3, Cloudflare R2, or platform default

Available for:SUPER ADMIN

In the super-admin panel, go to Tenants and click on the school you want to configure.

Screenshot: /help/screenshots/sa-tenant-detail.png

Screenshot will be added here

Scroll down to the "File Storage" card. It shows the current provider (or platform default).

Screenshot: /help/screenshots/sa-storage-section.png

Screenshot will be added here

Click one of the four provider tiles: None (platform default), UploadThing, AWS S3, or Cloudflare R2.

Screenshot: /help/screenshots/sa-storage-providers.png

Screenshot will be added here

💡

• "None" means the tenant uses the platform's global storage account
• UploadThing: paste the Token (starts with eyJ...) from uploadthing.com — not the API Key
• AWS S3: requires Access Key ID, Secret Access Key, Region, and Bucket Name
• Cloudflare R2: requires Access Key ID, Secret Access Key, Account ID, and Bucket Name

Fill in the required fields for the chosen provider. Tick "Show secret values" to verify what you pasted.

Screenshot: /help/screenshots/sa-storage-credentials.png

Screenshot will be added here

💡

• All credentials are encrypted at rest using AES-256
• For S3: create an IAM user with s3:PutObject and s3:DeleteObject permissions only
• For R2: create an API Token with Object Read & Write access on the specific bucket

Click "Save Configuration". Uploads for this tenant immediately use the new provider.

Screenshot: /help/screenshots/sa-storage-save.png

Screenshot will be added here

💡

• Switching back to "None" shows a "Remove stored configuration" button that wipes the credentials

🎉

You've completed the "Configuring File Storage for a Tenant" guide. You're now ready to use this feature!

📚 Related Guides

10 minutes

5 minutes