Skip to content
← Back to storage overview

Connect MinIO or a generic S3-compatible endpoint

This guide covers MinIO and any other storage that offers a genuine S3 API, whether self-hosted or from a smaller provider. It must be reachable from the Internet over HTTPS — a MinIO instance only reachable on your home network can't be connected yet (see the local NAS / home server guide).

1. A reachable, HTTPS MinIO endpoint

Set up MinIO (self-hosted or via a provider), and make sure it's reachable at a real HTTPS address with a valid TLS certificate — typically via a reverse proxy (Caddy, nginx, Traefik) in front of it. Don't expose MinIO's raw port to the Internet without TLS.

2. Create a bucket

Using the MinIO Console or the mc command-line tool, create a dedicated bucket — for example “<your-bucket-name>”.

3. Create a scoped access key

Create a dedicated MinIO user (or access key) with a policy restricted to read/write on only this bucket — not your MinIO root/admin credentials.

4. Endpoint and region

Endpoint: your MinIO server's public HTTPS address, for example https://minio.example.com. Region: MinIO doesn't require a specific value — “auto” works for most default setups; if MyArboris reports a region-related error, try “us-east-1”, a common MinIO default.

5. Access key ID and secret access key

Use the access key and secret key you created in step 3 for the scoped user — copy both, the secret is normally shown only once.

6. Path-style access

Check “Use path-style access.” A default MinIO instance (without its own wildcard DNS domain configured) only accepts path-style requests — leaving this unchecked will make every request fail.

7. Path prefix (optional)

If you're sharing this bucket with other tools, set a path prefix (for example “myarboris/”) so MyArboris's files stay in their own folder.

8. What to paste into MyArboris

Endpoint URL: your MinIO server's HTTPS address from step 4. Region: auto (or us-east-1, see step 4). Bucket name: the bucket from step 2. Access key ID / Secret access key: from step 5. Path prefix: optional, from step 7. Path-style access: checked, from step 6.

9. Test the connection

Click “Add storage” — MyArboris tests the connection automatically (a small write, read, and delete) and shows the result right away. If it fails, double-check “Use path-style access” is checked before anything else. You can re-run “Test connection” on the saved entry any time afterward.

Open Account → Storage in the app← Back to home