Skip to content

feat(storage): DigitalOcean Spaces disk + env documentation#53

Merged
paulocastellano merged 1 commit into
mainfrom
fix/digitalocean-spaces-env-naming
May 19, 2026
Merged

feat(storage): DigitalOcean Spaces disk + env documentation#53
paulocastellano merged 1 commit into
mainfrom
fix/digitalocean-spaces-env-naming

Conversation

@paulocastellano
Copy link
Copy Markdown
Contributor

Summary

Adds a dedicated `spaces` disk to `config/filesystems.php` so self-hosters can pick `FILESYSTEM_DISK=spaces` without bolting onto the generic `s3` disk.

Env vars follow the existing R2/AWS convention — `SPACES_ACCESS_KEY_ID` / `SPACES_SECRET_ACCESS_KEY` etc. — instead of inventing a new abbreviation. `use_path_style_endpoint` is intentionally omitted so the SDK defaults to virtual-hosted style (`https://{bucket}.{region}.digitaloceanspaces.com`), which is the canonical shape for DigitalOcean Spaces.

Changes

  • `config/filesystems.php` — `spaces` disk block.
  • `.env.example` — five `SPACES_*` variables documented alongside R2.
  • Docs PR (already merged on `main` at trypostit/trypost-docs@41ebdb0): `self-hosting/configuration.mdx` gets a dedicated DigitalOcean Spaces stanza paralleling R2.

Test plan

  • `php artisan config:show filesystems.disks.spaces` resolves with the right keys
  • Manual: real `.env` against a DO Spaces bucket, upload + retrieve via the public disk URL

🤖 Generated with Claude Code

Adds 'spaces' to config/filesystems.php so self-hosters can switch
FILESYSTEM_DISK=spaces without bolting onto the generic s3 disk. Env
vars follow the existing R2/AWS convention (SPACES_ACCESS_KEY_ID /
SPACES_SECRET_ACCESS_KEY), and use_path_style_endpoint is omitted so
the SDK defaults to virtual-hosted style — the canonical request shape
for DO Spaces.

Also documents the five env vars in .env.example. Docs in the
trypost-docs repo describe the matching FILESYSTEM_DISK=spaces stanza.
@paulocastellano paulocastellano merged commit 19f3b02 into main May 19, 2026
2 checks passed
@paulocastellano paulocastellano deleted the fix/digitalocean-spaces-env-naming branch May 19, 2026 15:39
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.

1 participant