Bucket Domains

Bucket domains let you serve files from an S3 storage bucket on your own domain. This is useful for static websites, asset CDNs, and file hosting.

Adding a bucket domain

1. Navigate to your bucket's Settings tab
2. Under Custom Domain, click Add Domain
3. Enter your domain (e.g., assets.myapp.com)
4. Create a CNAME record:

assets.myapp.com  CNAME  your-bucket-endpoint.smll.io

5. Click Verify — SMLL provisions a TLS certificate and begins serving files

How it works

When a request arrives at your custom domain:

1. SMLL resolves the domain to your bucket
2. The request path maps to an object key (e.g., /images/logo.png → images/logo.png)
3. The file is served with appropriate content-type headers
4. HTTPS is enforced automatically

Static website hosting

To host a static website from a bucket:

1. Upload your site files (e.g., index.html, style.css, app.js)
2. Add a custom domain
3. Access your site at https://your-domain.com

There is no special "static website" mode — files are served directly by key.

Limitations

• One custom domain per bucket
• No index document or error document configuration (yet)
• No redirect rules — use client-side routing for SPAs