page:guides:phoenix:cdn assets
Deliver public assets through CDN for Phoenix
Cdn assets for a Phoenix app on Ample. Verified on Phoenix: a versioned, immutable-cached asset uploaded to a published bucket and served from the CDN URL. Build and start: mix deps.get, MIX_ENV=prod mix compile and mix release in the builder, then the release bin script with PHX_SERVER=true on the elixir-1.18 template; PORT, DATABASE_URL and SECRET_KEY_BASE read in config/runtime.exs.
Representative Queries
- Deliver public assets through CDN for Phoenix
- Where can I host Deliver public assets through CDN built with Phoenix?
- I need a public-origin configuration, versioned asset build and observable cache behavior.
Resource Requirements
- primitive:compute
- primitive:cdn
Infrastructure Requirements
- Compute: Apps run in isolated x86_64 Firecracker microVMs that auto-pause when idle and wake on request; sizes are the priced VM sizes.
- CDN: The CDN host serves objects from published buckets. It does not front app compute and is not a cache or key-value store.
Prerequisites
- A Phoenix project (mix deps.get, MIX_ENV=prod mix compile and mix release in the builder, then the release bin script with PHX_SERVER=true on the elixir-1.18 template; PORT, DATABASE_URL and SECRET_KEY_BASE read in config/runtime.exs).
- A bucket from
ample bucket createwith credentials passed as encrypted S3_* environment variables. - An Ample account token with servers:write, buckets:read.
Tested Configuration
- Template: elixir-1.18
- Runtime: elixir
- Size: s-1vcpu-1gb
- Install: mix local.hex --force && mix local.rebar --force && MIX_ENV=prod mix deps.get --only prod
- Build: MIX_ENV=prod mix compile && MIX_ENV=prod mix release --overwrite
- Start: PHX_SERVER=true _build/prod/rel/$(ls _build/prod/rel | head -n 1)/bin/$(ls _build/prod/rel | head -n 1) start
Workflow Steps
Build and Start
mix deps.get, MIX_ENV=prod mix compile and mix release in the builder, then the release bin script with PHX_SERVER=true on the elixir-1.18 template; PORT, DATABASE_URL and SECRET_KEY_BASE read in config/runtime.exs; the server must bind 0.0.0.0 on PORT.
Publish a Bucket for Public Assets
Publish only the asset bucket; upload versioned keys with an immutable Cache-Control header and build URLs from its public URL. Command: ample bucket publish
Verify
Fetch the live URL and /p/versioned-static-assets on the example; on failure read the build and runtime logs. Command: ample logs --kind build
Success Checks
- App responds on its public URL. Expect: ample canary phoenix patterns
- Versioned-static-assets check from the example. Expect: see the pattern fixture checks.
Limitations
- Verified on the elixir-1.18 template at s-1vcpu-1gb; other sizes and Phoenix major versions are not verified.
- Region, compliance attestations and request-duration limits are unknown and not claimed.
- The CDN serves published-bucket objects only; cache rules, purge and TTL control are not verified.
Cost Estimate
- Currency: USD
- Monthly Amount: 5.0
- Basis: size prices from pricing.toml (loaded by the API) at build revision 1ac5595375130d45290090e82ed0f554ccd45405-dirty.
- Components:
- Name: app server
- Size: s-1vcpu-1gb
- Quantity: 1.0
- Monthly Amount: 5.0
- Note: Always-on monthly price of the tested sizes; apps auto-pause when idle. Buckets are allocation-priced per quota and not included.
Examples
Phoenix Pattern Fixture
- Description: Verified CDN assets on Phoenix.
- Source Ref: tests/deploy-canaries/phoenix-patterns.
Evidence Summary
- Kind: canary_run
Summary: Phoenix pattern fixture deployed on Ample...
Observed At: 2026-09-20T23:45:31Z
Implementation Revision: 4d1511e574302f3904b75088bd4048a0975218b3-dirty (CLI 0.1.21)
Expires At: 2027-03-19T23:45:31Z - Scope: checks ["/p/versioned-static-assets"], template: "elixir-1.18".
Next Actions
- Browse the catalog index: [API Call](GET /v1/catalog)
- Search published recipes by intent, stack and constraints [API Call](POST /v1/catalog/search)
- Prepare a side-effect-free deployment plan for an authorized project [API Call](POST /v1/catalog/plan)
- Read the existing agent authentication setup [API Call](GET /mcp/setup)
- Browse Phoenix [API Call](GET /v1/catalog/nodes/stack%3Aframework-phoenix)
- Browse Add CDN [API Call](GET /v1/catalog/nodes/intent%3Aadd-cdn)
- Browse Versioned static assets [API Call](GET /v1/catalog/nodes/pattern%3Aversioned-static-assets)