On-Prem S3 Object Storage (Garage)¶

Object storage is frequently used in cloud applications. The internal S3 object storage is provided by a container running on the Synology called "Garage"

Bucket provisioning¶

1. Allocating Object Storage starts with a bucket. To create a new bucket, run the following on the Synology nas:
   

   sudo docker run -rm -it -network container:dxflrs-garage --volumes-from fxflrs-garage dxflrs/garage:b6b18427a5fc9b5b7540cf6d0843afd5cf7f9b56 /garage bucket create mybucketname
   

2. Create an application key to control access to the bucket:
   

   sudo docker run -rm -it -network container:dxflrs-garage --volumes-from fxflrs-garage dxflrs/garage:b6b18427a5fc9b5b7540cf6d0843afd5cf7f9b56 /garage key create myapp-app-key
   

   
   !!! Info "Record the generated details"
   Record the generated ClientID and ClientSecret as you will need this information to access the bucket

3. Finally, we'll assign permissions linking the bucket and the key:
   

   sudo docker run -rm -it -network container:dxflrs-garage --volumes-from fxflrs-garage dxflrs/garage:b6b18427a5fc9b5b7540cf6d0843afd5cf7f9b56 /garage bucket allow --read --write --owner mybucketname --key myapp-app-key
   

Accessing the bucket¶

The following information is required to utilize the bucket in the application, s3 command-line utilties or s3 browser

Attribute	Value
Endpoint	s3.endofday.com:49614
TLS	False
Addressing Model	Path
Region	garage