Support for Minio

README.md

@@ -119,6 +119,19 @@ Replace config file located `~/config/imageprocessor/security.config`
 </security>
 ```
 
+## Using Minio
+
+It is possible to use the provider with a (self-hosted) Minio (https://min.io). Minio requires that ForcePathStyle config settings is true and there needs to be specified a custom URL for the Minio/S3 instance.
+
+Add the following extra settings for Minio to work
+
+```xml
+    <add key="BucketFileSystem:ServiceUrl" value="http://localhost:9000" />
+    <add key="BucketFileSystem:ForcePathStyle" value="true" />
+```
+
+Note: Minio uses `us-east-1` as the default region.
+
 ## Future work on this project
 Due to not having access to the original Umbraco.Storage.S3 package name I've released the NuGet package under `Our.Umbraco.FileSystemProviders.S3...`. Add in the Web.config keys and we have 3 different naming conventions. I intend to resolve this at some point in the future. If the Web.config keys are changed then I will ensure the new names are optional and the old keys will continue to work.
 

Umbraco.Storage.S3/Umbraco.Storage.S3.Forms/BucketFormsFileSystemComposer.cs

@@ -30,12 +30,19 @@ public void Compose(Composition composition)
                 composition.RegisterUnique(config);
                 composition.Register<IMimeTypeResolver>(new DefaultMimeTypeResolver());
 
+                var s3config = new AmazonS3Config()
+                {
+                    RegionEndpoint = Amazon.RegionEndpoint.GetBySystemName(config.Region),
+                    ForcePathStyle = config.ForcePathStyle,
+                    ServiceURL = config.ServiceUrl
+                };
+
                 composition.RegisterUniqueFor<IFileSystem, FormsFileSystemForSavedData>(f => new BucketFileSystem(
                     config: config,
                     mimeTypeResolver: f.GetInstance<IMimeTypeResolver>(),
                     fileCacheProvider: null,
                     logger: f.GetInstance<ILogger>(),
-                    s3Client: new AmazonS3Client(Amazon.RegionEndpoint.GetBySystemName(config.Region))
+                    s3Client: new AmazonS3Client(s3config)
                 ));
             }
 
@@ -46,6 +53,8 @@ private BucketFileSystemConfig CreateConfiguration()
             var bucketName = ConfigurationManager.AppSettings[$"{AppSettingsKey}:BucketName"];
             var bucketHostName = ConfigurationManager.AppSettings[$"{AppSettingsKey}:BucketHostname"];
             var bucketPrefix = ConfigurationManager.AppSettings[$"{AppSettingsKey}:FormsPrefix"];
+            var serviceUrl = ConfigurationManager.AppSettings[$"{AppSettingsKey}:ServiceUrl"];
+            bool.TryParse(ConfigurationManager.AppSettings[$"{AppSettingsKey}:ForcePathStyle"], out var forcepathstyle);
             var region = ConfigurationManager.AppSettings[$"{AppSettingsKey}:Region"];
             bool.TryParse(ConfigurationManager.AppSettings[$"{AppSettingsKey}:DisableVirtualPathProvider"], out var disableVirtualPathProvider);
 
@@ -65,6 +74,8 @@ private BucketFileSystemConfig CreateConfiguration()
             {
                 BucketName = bucketName,
                 BucketHostName = bucketHostName,
+                ServiceUrl = serviceUrl,
+                ForcePathStyle = forcepathstyle,
                 BucketPrefix = bucketPrefix.Trim(Delimiters),
                 Region = region,
                 CannedACL = new S3CannedACL("public-read"),

Umbraco.Storage.S3/Umbraco.Storage.S3.Media/BucketMediaFileSystemComposer.cs

@@ -25,12 +25,19 @@ public void Compose(Composition composition)
                 composition.RegisterUnique(config);
                 composition.Register<IMimeTypeResolver>(new DefaultMimeTypeResolver());
 
+                var s3config = new AmazonS3Config()
+                {
+                    RegionEndpoint = Amazon.RegionEndpoint.GetBySystemName(config.Region),
+                    ForcePathStyle = config.ForcePathStyle,
+                    ServiceURL = config.ServiceUrl
+                };
+
                 composition.SetMediaFileSystem((f) => new BucketFileSystem(
                     config: config,
                     mimeTypeResolver: f.GetInstance<IMimeTypeResolver>(),
                     fileCacheProvider: null,
                     logger: f.GetInstance<ILogger>(),
-                    s3Client: new AmazonS3Client(Amazon.RegionEndpoint.GetBySystemName(config.Region))
+                    s3Client: new AmazonS3Client(s3config)
                 ));
 
                 composition.Components().Append<BucketMediaFileSystemComponent>();
@@ -43,6 +50,8 @@ private BucketFileSystemConfig CreateConfiguration()
         {
             var bucketName = ConfigurationManager.AppSettings[$"{AppSettingsKey}:BucketName"];
             var bucketHostName = ConfigurationManager.AppSettings[$"{AppSettingsKey}:BucketHostname"];
+            var serviceUrl = ConfigurationManager.AppSettings[$"{AppSettingsKey}:ServiceUrl"];
+            bool.TryParse(ConfigurationManager.AppSettings[$"{AppSettingsKey}:ForcePathStyle"], out var forcepathstyle);
             var bucketPrefix = ConfigurationManager.AppSettings[$"{AppSettingsKey}:MediaPrefix"];
             var region = ConfigurationManager.AppSettings[$"{AppSettingsKey}:Region"];
             bool.TryParse(ConfigurationManager.AppSettings[$"{AppSettingsKey}:DisableVirtualPathProvider"], out var disableVirtualPathProvider);
@@ -63,6 +72,8 @@ private BucketFileSystemConfig CreateConfiguration()
             {
                 BucketName = bucketName,
                 BucketHostName = bucketHostName,
+                ServiceUrl = serviceUrl,
+                ForcePathStyle = forcepathstyle,
                 BucketPrefix = bucketPrefix.Trim(Delimiters),
                 Region = region,
                 CannedACL = new S3CannedACL("public-read"),

Umbraco.Storage.S3/Umbraco.Storage.S3/BucketFileSystemConfig.cs

@@ -7,6 +7,8 @@ public class BucketFileSystemConfig
         public string BucketName { get; set; }
 
         public string BucketHostName { get; set; }
+        public string ServiceUrl { get; set; }
+        public bool ForcePathStyle { get; set; }
 
         public string BucketPrefix { get; set; }