Sync NextOS with
S3-compatible storage
Bring your own S3 bucket - AWS or any S3-compatible endpoint like MinIO - with credentials that never leave the server.
01What syncs
Your files,
kept in step.
- One bucket (or a prefix within it) mirrored against your NextOS VFS
- Any S3-compatible provider, not just AWS - MinIO and other self-hosted stores work via the same adapter, with an optional path-style URL toggle for the ones that need it
- Large files via S3 multipart upload above a 64 MB threshold
02How the connection works
Authentication,
handled once.
Your own credentials, encrypted server-sideYou enter an access key, secret key, bucket, region and (for a non-AWS endpoint) a custom URL directly in Settings. Those credentials are encrypted server-side and never sent to the browser; every read and write is proxied through the server, which is also why S3 needs no OAuth app or redirect at all.
03Setup
Three steps,
start to finish.
Open Settings > Cloud storage and choose S3-compatible
Enter the bucket, region, access key and secret key (and endpoint URL, if not AWS)
Save - NextOS validates the credentials server-side and starts syncing on the schedule in Settings
04Limits, honestly
What it
won't do.
- No native change feed - S3 has none, so every sync pass lists the bucket to see what moved, which costs more at very large object counts than the OAuth providers' delta feeds
- Credentials are decrypted only inside the server-side proxy route, never sent to or held in the browser
- Files over 64 MB automatically use multipart upload; below that, a single PUT
05FAQ
Common
questions.
Do my AWS credentials ever reach my browser?
No - S3 is a credentials-kind provider: the encrypted secret lives server-side and every operation goes through a server proxy route, never a direct browser-to-S3 call.
Does this work with MinIO or other self-hosted S3-compatible stores?
Yes - set a custom endpoint URL and, if the server needs it, the path-style URL option; the same adapter drives both AWS and self-hosted endpoints.
Is there a size limit on synced files?
No NextOS-imposed limit - files above 64 MB automatically switch to multipart upload.
your files · one place · every device