Skip to main content
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:
la.storage.bunnycdn.com
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