Build Status

Welcome to the Amazon S3 SDK

This SDK allows you to add Amazon S3 capabilities to your ColdFusion (CFML) applications. It is also a ColdBox Module, so if you are using ColdBox, you get auto-registration and much more.


  • Source:
  • Issues:
  • Changelog
  • S3 API Reference:


This SDK can be installed as standalone or as a ColdBox Module. Either approach requires a simple CommandBox command:

box install s3sdk

Then follow either the standalone or module instructions below.


This SDK will be installed into a directory called s3sdk and then the SDK can be instantiated via new s3sdk.AmazonS3() with the following constructor arguments:

<cfargument name="accessKey" 			required="true">
<cfargument name="secretKey" 			required="true">
<cfargument name="encryption_charset" 	required="false" default="utf-8">
<cfargument name="ssl" 					required="false" default="false">

ColdBox Module

This package also is a ColdBox module as well. The module can be configured by creating an s3sdk configuration structure in your application configuration file: config/Coldbox.cfc with the following settings:

s3sdk = {
	// Your amazon access key
	accessKey = "",
	// Your amazon secret key
	secretKey = "",
	// The default encryption character set
	encryption_charset = "utf-8",
	// SSL mode or not on cfhttp calls.
	ssl = false

Then you can leverage the SDK CFC via the injection DSL: [email protected]


Please check out the included API Docs to see all the methods available to you using our S3 SDK.


  • Travis Updates and self-publishing


  • Ugprade to ColdBox 4 standards
  • Upgrade to latest Amazon S3 SDK standards
  • Travis build process


  • Original Spec as a ColdBox Plugin


$ box install s3sdk
No collaborators yet.
5.00 / 3
  • Nov 25 2009 03:34 AM
  • Jan 18 2018 09:40 PM
  • 11632
  • 10498
  • 871