Bunny stores and serves maintenance media so operator-facing images do not depend on authenticated provider URLs.
Role
Bunny is used for:
media storage
public CDN delivery
maintenance photo rendering
provider-independent file access
Why Bunny Is Required
Twilio media URLs require authentication.
Browser-rendering Twilio URLs directly causes broken images.
The correct flow is:
Twilio media URLauthenticated server fetchBunny Storage uploadBunny CDN URLAdmin UI render
Required Environment Variables
BUNNY_STORAGE_ZONE
BUNNY_STORAGE_HOST
BUNNY_CDN_BASE_URL
BUNNY_STORAGE_PASSWORD
Important:
BUNNY_STORAGE_ZONE must be the zone name, not numeric ID.
Known Correct Pattern
Storage host:
CDN base URL:
https://Lucia-Maintenance-Inbox.b-cdn.net
The storage API hostname must not be used as the public image URL.
Current Status
Twilio SMS/MMS media → working
Twilio WhatsApp media → working
Postmark email attachments → deferred
Common Failure Modes
twilio_media_auth_missing
bunny_upload_failed_401
using storage host as CDN URL
wrong storage zone value
See Also