Skip to content

docs: document public bucket access and fix custom domain CNAME target#406

Merged
katieschilling merged 5 commits into
mainfrom
katieschilling/public-access-docs
Apr 6, 2026
Merged

docs: document public bucket access and fix custom domain CNAME target#406
katieschilling merged 5 commits into
mainfrom
katieschilling/public-access-docs

Conversation

@katieschilling
Copy link
Copy Markdown
Contributor

@katieschilling katieschilling commented Apr 6, 2026

Summary

  • Add "Accessing objects in a public bucket" section to docs/sdks/fly/index.md listing the three dedicated public content domains (t3.tigrisfiles.io, t3.tigrisbucket.io, t3.tigrisblob.io) with examples and a custom domain recommendation
  • Update the public bucket domains table in docs/buckets/public-bucket.md to list the three dedicated public content domains
  • Note that existing Fly.io accounts can still use fly.storage.tigris.dev for public access, but this is not available for new accounts
  • Fix CNAME target for custom domains from t3.storage.dev to t3.tigrisbucket.io
  • Fix CNAME target in the Fly SDK guide from fly.storage.tigris.dev to t3.tigrisbucket.io
  • Recommend custom domains for production use

Context

A user's AI coding assistant told them that fly.storage.tigris.dev "does not support anonymous access, even for public buckets." The root cause: the docs only showed fly.storage.tigris.dev as the authenticated S3 API endpoint and didn't clearly document the dedicated public content domains or that public bucket objects are anonymously accessible.

Per the public bucket domains announcement, new accounts serve public content from t3.tigrisfiles.io (and two alternate domains), separate from the API infrastructure. Existing accounts can continue using fly.storage.tigris.dev for public access. Custom domain CNAMEs should point to BUCKET.t3.tigrisbucket.io.

Companion PR to Fly docs: superfly/docs#2372

Test plan

  • npm run build passes
  • npm run lint passes (prettier clean on changed files)
  • Verify public bucket page renders the domains table correctly

🤖 Generated with Claude Code


Note

Low Risk
Low risk documentation-only changes; main risk is potential confusion if domain guidance is incorrect or incomplete.

Overview
Public bucket access docs are updated to explicitly document anonymous reads via the dedicated public content domains (t3.tigrisfiles.io, t3.tigrisbucket.io, t3.tigrisblob.io), including examples and guidance that the domains are interchangeable.

Adds notes that *.fly.storage.tigris.dev public access remains for existing Fly.io accounts only, and fixes custom domain CNAME instructions to point to BUCKET_NAME.t3.tigrisbucket.io (including in the Fly SDK docs), with a recommendation to use custom domains for production.

Reviewed by Cursor Bugbot for commit 1e87ca2. Bugbot is set up for automated code reviews on this repo. Configure here.

AI tools were incorrectly telling users that fly.storage.tigris.dev
doesn't support anonymous access for public buckets. Add explicit
documentation that public buckets are accessible without authentication,
with URL examples, to both the Fly SDK guide and the public bucket
reference.

Assisted-by: Claude Opus 4.6 via Claude Code
Co-Authored-By: Claude Opus 4.6 <[email protected]>
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 6, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs-redirect Ready Ready Preview, Comment Apr 6, 2026 7:57pm
tigris-os-docs Ready Ready Preview, Comment Apr 6, 2026 7:57pm

Request Review

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented Apr 6, 2026

Greptile Summary

Adds fly.storage.tigris.dev to the public bucket domains table in docs/buckets/public-bucket.md and adds a new "Accessing objects in a public bucket" section to the Fly.io SDK guide, correcting the documentation gap that caused AI tools to incorrectly conclude the domain required authentication.

Confidence Score: 5/5

Safe to merge — purely documentation additions that accurately reflect product behavior

All findings are P2 style only (a single 'the Tigris' phrasing issue); the content is factually correct and fills a real documentation gap

docs/sdks/fly/index.md has a minor naming-convention issue on line 87

Important Files Changed

Filename Overview
docs/buckets/public-bucket.md Adds fly.storage.tigris.dev to the public bucket domains table and updates surrounding prose from 'three' to 'several' with a Fly.io qualifier note
docs/sdks/fly/index.md Adds new 'Accessing objects in a public bucket' section with URL pattern, example, and explicit no-credentials statement

Reviews (1): Last reviewed commit: "docs: clarify public bucket anonymous ac..." | Re-trigger Greptile

Comment thread docs/sdks/fly/index.md Outdated
No credentials or signed URLs are needed — the URL works directly in a browser,
`curl`, `wget`, `<img>` tags, etc.

Public buckets are also accessible via the Tigris-managed domains
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 'the' before 'Tigris' violates naming convention

Per the project's documentation style rule, the definite article 'the' should not appear directly before 'Tigris'. Rephrase "the Tigris-managed domains" to drop the article.

Suggested change
Public buckets are also accessible via the Tigris-managed domains
Public buckets are also accessible via Tigris-managed domains

Rule Used: Don't use the definite article 'the' before 'Tigri... (source)

Learnt From
tigrisdata/tigris-os-docs#262

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Comment thread docs/buckets/public-bucket.md Outdated
| `BUCKET_NAME.t3.tigrisbucket.io` | `https://foo-public-bucket.t3.tigrisbucket.io/bar.txt` |
| Domain | Example URL |
| ------------------------------------ | ---------------------------------------------------------- |
| `BUCKET_NAME.fly.storage.tigris.dev` | `https://foo-public-bucket.fly.storage.tigris.dev/bar.txt` |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok so the anonymous access for public access only works on the new .io domains for new users.

The customer in question is an existing customer who are not restricted. So probably this tigris.dev domain doesn't need to be here.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe this comment was on an outdated version?

@ovaistariq
Copy link
Copy Markdown
Contributor

May be we need to clarify that authenticated access to buckets is always done via our t3 or fly.storage endpoint. While serving content via public bucket requires using these new domains

Update public bucket docs to use t3.tigrisfiles.io as the primary
public content domain per the public bucket domains announcement.
Remove fly.storage.tigris.dev from the public domains table (it is the
S3 API endpoint, not a public content domain). Fix CNAME target for
custom domains to t3.tigrisbucket.io. Add custom domain recommendation
to the Fly SDK guide.

Assisted-by: Claude Opus 4.6 via Claude Code
Co-Authored-By: Claude Opus 4.6 <[email protected]>
@katieschilling katieschilling changed the title docs: clarify public bucket anonymous access via fly.storage.tigris.dev docs: document public bucket access and fix custom domain CNAME target Apr 6, 2026
Existing Fly.io accounts can still use fly.storage.tigris.dev for
anonymous public access, but this is not available for new accounts.
Clarify this in both the Fly SDK guide and public bucket docs to avoid
confusing existing users while directing new users to the dedicated
public content domains.

Assisted-by: Claude Opus 4.6 via Claude Code
Co-Authored-By: Claude Opus 4.6 <[email protected]>
ovaistariq
ovaistariq previously approved these changes Apr 6, 2026
Move the fly.storage.tigris.dev existing-account note out of the
general public bucket documentation per reviewer feedback. This detail
is Fly-specific and already documented in the Fly SDK guide.

Assisted-by: Claude Opus 4.6 via Claude Code
Co-Authored-By: Claude Opus 4.6 <[email protected]>
@katieschilling katieschilling merged commit 0d500f7 into main Apr 6, 2026
11 checks passed
@katieschilling katieschilling deleted the katieschilling/public-access-docs branch April 6, 2026 20:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants