S3 Transfers
simultaneouslyPerform verified file transfers directly to an S3 bucket using OffShoot.
Requirements
OffShoot 23.2 or newer
A Pro License
Access to an S3 bucket with at least
write
,delete
andlistBucket
permissions
How to use
Go to
Settings > Cloud
.Choose an S3 provider from the list or
Generic S3
.Click
Add...
to create a new S3 connection.

Enter your S3 credentials – the
Address
,Bucket Name
,Access Key
, andSecret
.

Click
Connect
.The S3 bucket will now be available as a Disk in OffShoot.
AWS S3 Transfer acceleration
AWS S3 buckets with Transfer Acceleration are supported in OffShoot 24.1 and newer.

Configuring the S3 Connection
Connecting to a path
You can also define an Optional Path
as part of your S3 bucket's Location
, which OffShoot will mount as your S3 bucket's "root point".


Using a Label
By default, OffShoot uses the Bucket name
as the disk name. As with other disks in OffShoot, you can rename it with a Label
when creating or configuring the connection.


Configuring an S3 connection via CLI (macOS only)
It's possible to create a connection via the command line. Learn more.
Browsing a Bucket
Once your S3 bucket is connected, you can browse it in OffShoot by:
Double-clicking the S3 bucket's disk icon.
Choosing
Browse...
from the Disk's menu.

Editing / Removing a Connection
You can edit or remove an existing S3 connection by:
Double-clicking the connection.
Clicking the ellipses
⋯
, then choosingEdit
orRemove.

Setting a Destination Folder
It's possible to set a Destination folder via Disk menu
> Destination Folder
> Browse...

New folder creation is also possible, but OffShoot only creates those at transfer time.
Verification
S3 transfers are always verified using multi-part MD5 checksums. This is done server-side and does not require a readback of the files or Checkpoint being ON.
Concurrency
OffShoot uploads multiple files (in parts) to S3 at the same time. To adjust these settings, you can modify the following defaults:
multi-part// sets the multi-part size in MB; default = 64 (min 5 MB, max 5GB)
defaults write nl.syncfactory.Hedge.Mac "S3MultipartSize" -int <size in MB>
// sets the maximum amount of parts uploaded simultaneously; default = 10
defaults write nl.syncfactory.Hedge.Mac "S3MultipartConcurrencyLimit" -int <amount in parts>
// delete these keys if you want the reset to the default values
defaults delete nl.syncfactory.Hedge.Mac "S3MultipartSize"
defaults delete nl.syncfactory.Hedge.Mac "S3MultipartConcurrencyLimit"
API
To set an S3 bucket with the API, use the setDestination
call with Bucket Name
and Optional Path
as the path
parameter's value:
offshoot://setDestination?path=hedge-s3-test
Limitations
Setting an S3 bucket as a
Source
is currently unsupported.Transfers will use the
Standard
storage class.Local S3 connections using self-signed certificates are currently unsupported.
Due to S3 limitations, OffShoot cannot transfer:
Empty folders
File aliases/symlinks
Zero byte files
Files larger than 5TiB
Due to S3 limitations, the FoolCat, EditReady, and iconik integrations are unsupported.
OffShoot logs any files or folders that couldn't be transferred in the Transfer Logs.
Generic S3
If you don't have an AWS S3 bucket, you can try the generic S3 integration. Use at your own discretion.
Last updated