BarakoCMS.Files.S3 4.1.1

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package BarakoCMS.Files.S3 --version 4.1.1
                    


                    

                
NuGet\Install-Package BarakoCMS.Files.S3 -Version 4.1.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="BarakoCMS.Files.S3" Version="4.1.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="BarakoCMS.Files.S3" Version="4.1.1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="BarakoCMS.Files.S3" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add BarakoCMS.Files.S3 --version 4.1.1
                    


                    

                
#r "nuget: BarakoCMS.Files.S3, 4.1.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package BarakoCMS.Files.S3@4.1.1
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=BarakoCMS.Files.S3&version=4.1.1
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=BarakoCMS.Files.S3&version=4.1.1
                    


                            Install as a Cake Tool

<div align="center"> <img src="https://raw.githubusercontent.com/BaryoDev/barakoCMS/master/assets/icon.png" width="96" height="96" alt="BarakoCMS.Files.S3 logo" /> <h1>BarakoCMS.Files.S3</h1> <p><em>S3-compatible object storage for the barakoCMS Files module.</em></p> </div>

Stores uploads in AWS S3, Cloudflare R2, or a self-hosted store that speaks the S3 API, instead of on the application's own disk. Public files get a direct, CDN-friendly URL; private files stay private and are proxied through the API so authorisation is still checked on every read.

Enable it

It depends on the Files module, which owns the upload endpoints. The package brings Files in with it, so one reference is enough; enable both:

dotnet add package BarakoCMS.Files.S3

builder.Services.AddBarakoCMS(builder.Configuration);

var app = builder.Build();
app.UseBarakoCMS();

The package reference plus a restart is the install. AddBarakoCMS finds every module in the application's dependency context, and BarakoCMS:Modules:Enabled decides which of them run (BarakoCMS__Modules__Enabled=Files,Files.S3). Unset, every referenced module runs and the API logs one warning saying so. To name it by hand instead, put modules.Add(new BarakoCMS.Files.S3.S3FilesModule()) in the AddBarakoCMS callback; discovery skips a type the host already added. See MODULES.md in the repository.

Configuration

{
  "Files": {
    "S3": {
      "Bucket": "my-bucket",
      "Region": "us-east-1",
      "AccessKey": "...",
      "SecretKey": "...",
      "ServiceUrl": null,
      "ForcePathStyle": false,
      "PublicBaseUrl": null,
      "UsePublicReadAcl": false
    }
  }
}

The section is Files:S3. With no Files:S3:Bucket set the provider stays dormant and the default storage keeps serving, so a typo here shows up as "uploads still work but nothing reaches the bucket" rather than as an error.

Key Notes
ServiceUrl Set for R2 or a self-hosted store; leave null for AWS
ForcePathStyle Usually true for self-hosted stores
PublicBaseUrl Serve public files from your CDN domain
UsePublicReadAcl Leave false on buckets that block public ACLs, which is the safer default

Keys belong in environment variables or a secret store, never in a checked-in appsettings.json.

S3-compatible stores

Store Notes
AWS S3 Leave ServiceUrl null and set Region. UsePublicReadAcl only works on a bucket with ACLs enabled.
Cloudflare R2 No object ACLs: make the bucket public in the R2 dashboard and set UsePublicReadAcl to false.
SeaweedFS Apache-2.0. The module's own tests run against it. Does not apply an ACL sent with an upload, so make the bucket public and set UsePublicReadAcl to false.
Garage AGPL-3.0. No object ACLs, so treat it like R2 and set UsePublicReadAcl to false.
MinIO Unmaintained. The upstream repository is archived and gets no security patches, so it is not recommended for new deployments.

Part of barakoCMS

This is an optional module for barakoCMS, an open-source headless CMS for .NET 10. Every module is published under the barakocms-module tag, so a single search on nuget.org returns the whole set.

Contributions are welcome — including a module icon or other design work. See CONTRIBUTING.md.

Licensed under MPL-2.0.

If barakoCMS is useful to you, a star on the repository helps other people find it.

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
5.1.0 66 10/23/2026
5.0.0 92 10/14/2026
4.3.0 88 10/12/2026
4.2.0 105 10/4/2026
4.1.2 107 9/26/2026
4.1.1 114 9/18/2026
4.0.0 134 9/7/2026
0.3.0 125 8/20/2026
0.1.3 127 8/15/2026
0.1.1 131 8/3/2026
0.1.0 120 7/27/2026