BucketWorxWindows · macOS · Linux

Connect MinIO or another S3-compatible server

Last updated: October 28, 2026

Any server that speaks the S3 protocol works in BucketWorx, including MinIO and servers you run yourself. You give BucketWorx the server's address and a key, and it handles the rest.

Add the server

  1. Click Add account.
  2. Choose MinIO from the Provider drop-down. For another kind of S3-compatible server, choose the S3-compatible option instead. Both ask for the same things.
  3. Give the account a name.
  4. Type the server's address in Endpoint URL, for example http://localhost:9000 or https://storage.example.com.
  5. Check Use path-style addresses. MinIO and most self-hosted servers want it on, and choosing the MinIO provider turns it on for you.
  6. Enter the access key ID and secret access key an administrator created, or the server's root user and password.
  7. Press Test connection, then Save.
The account form for a MinIO server: provider, name, region, endpoint URL, checksums, path-style addresses, a Trust a custom certificate button, and access key fields.
The MinIO form. Region defaults to us-east-1, which most self-hosted servers ignore.
The MinIO form after Test connection, showing the message Connected. Found 3 buckets.
A successful test.

A self-signed or private certificate

If your server uses HTTPS with a self-signed certificate, or one from a private certificate authority, BucketWorx will refuse to connect. Press Trust a custom certificate… and choose the certificate file the server's administrator gave you (.pem, .crt or .cer). The usual security checks stay on. BucketWorx only adds your certificate to the ones it trusts for this account, and it refuses a file that contains a private key.

Common problems

What you can do next

More guides