Aktar
EN
Download

About 5 minutes

How to use Aktar with MinIO

MinIO lets you run S3-compatible storage on your own server. Aktar's MinIO preset uses path-style addressing (https://server/bucket/file), which is what most self-hosted setups expect.

What you need

  • A MinIO server reachable from your Mac, ideally over HTTPS
  • The MinIO Client (mc) or access to the MinIO Console
  • Aktar installed on your Mac

Step by step

  1. 1

    Create a bucket

    Using the MinIO Client with an alias for your server:

    mc mb myminio/screenshots
  2. 2

    Allow anonymous downloads

    Give the bucket a public read policy so shared links open for anyone:

    mc anonymous set download myminio/screenshots
  3. 3

    Create an access key

    In the MinIO Console, create an access key (or a dedicated user with read-write access to the bucket) and copy the Access Key and Secret Key.

  4. 4

    Add the destination in Aktar

    In Settings → Destinations → Add Destination, choose MinIO and enter the values below. Because MinIO uses path-style URLs, the Public Base URL includes the bucket name.

  5. 5

    Test and save

    Click Test Connection, then Save.

Settings in Aktar

Enter these values in Settings → Destinations → Add Destination. Field names match the app.

FieldExample value
ProviderMinIO
Endpointhttps://minio.example.comYour MinIO API address (often port 9000).
Regionus-east-1Your server's configured region; us-east-1 if you never set one.
Access Key IDaktar
Secret Access Key••••••••
Bucketscreenshots
Public Base URLhttps://minio.example.com/screenshotsIncludes the bucket name.

Tips

  • Put MinIO behind a reverse proxy with HTTPS so links work in every browser and chat app.
  • Uploads only need your Mac to reach the server (a VPN or LAN is fine), but shared links need the public URL to be reachable by whoever opens them.

Troubleshooting

Test Connection reports a region or signature error

Set Region to the region configured on your MinIO server. If you never configured one, use us-east-1.

Links return 403

The bucket has no anonymous read policy, or the Public Base URL is missing the bucket name. See Access Denied errors.

Still stuck?Browse the FAQ or ask on GitHub.