About 5 minutes

How to use Aktar with Wasabi, Hetzner, Scaleway & other S3-compatible storage

Aktar works with any provider that implements the Amazon S3 API. Choose Other S3-Compatible and enter the provider's endpoint, region and keys. Common examples:

  • Wasabi: https://s3.<region>.wasabisys.com, for example s3.eu-central-1.wasabisys.com
  • Hetzner Object Storage: https://<location>.your-objectstorage.com, for example fsn1.your-objectstorage.com
  • Scaleway: https://s3.<region>.scw.cloud, for example s3.fr-par.scw.cloud
  • Akamai (Linode): https://<region>.linodeobjects.com

What you need

  • An account with an S3-compatible provider
  • Aktar installed on your Mac

Step by step

  1. 1

    Create a bucket

    Create a bucket in your provider's console and note its region or location, for example eu-central-1, fsn1 or fr-par.

  2. 2

    Allow public reads

    Make objects in the bucket publicly readable, using the provider's bucket visibility setting or a bucket policy that allows s3:GetObject. Aktar doesn't set per-file permissions, so this has to be configured on the bucket.

  3. 3

    Create access keys

    Create an S3 access key and secret with read and write access to the bucket.

  4. 4

    Add the destination in Aktar

    In Settings → Destinations → Add Destination, choose Other S3-Compatible and enter the values below. This preset uses virtual-hosted style URLs (bucket.endpoint). If your server only supports path-style URLs, choose the MinIO preset instead.

  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
ProviderOther S3-Compatible
Endpointhttps://fsn1.your-objectstorage.comYour provider's S3 endpoint.
Regionfsn1The bucket's region or location.
Access Key ID…
Secret Access Key••••••••
Bucketyour-bucket
Public Base URLyour-bucket.fsn1.your-objectstorage.comOr a CDN or custom domain in front of the bucket.

Tips

  • Check your provider's documentation for the exact endpoint of the region you picked.
  • If your provider offers a CDN or custom domains, use that address as Public Base URL.

Troubleshooting

Test Connection can't reach the bucket

Double-check the endpoint and region. If the provider only supports path-style URLs, switch the preset to MinIO.

Links return 403

The bucket doesn't allow public reads yet. See Access Denied errors.

Still stuck?Browse the FAQ or ask on GitHub.