node package manager


mongoose-crate StorageProvider that uploads files to Amazon S3


A StorageProvider for mongoose-crate that stores files in Amazon S3 buckets

var mongoose = require('mongoose'),
  crate = require('mongoose-crate'),
  S3 = require('mongoose-crate-s3')
var PostSchema = new mongoose.Schema({
  title: String,
  description: String
PostSchema.plugin(crate, {
  storage: new S3({
    key: '<api-key-here>',
    secret: '<secret-here>',
    bucket: '<bucket-here>',
    acl: '<acl-here>', // defaults to public-read 
    region: '<region-here>', // defaults to us-standard 
    pathfunction(attachment) { // where the file is stored in the bucket - defaults to this function 
      return '/' + path.basename(attachment.path)
  fields: {
    file: {}
var Post = mongoose.model('Post', PostSchema)

.. then later:

var post = new Post()
post.attach('image', {path: '/path/to/image'}, function(error) {
  // file is now uploaded and post.file is populated e.g.: 
  // post.file.url 

By default the region is assumed to be us-standard. The region is used to assemble the endpoint so please specify a different one if you are hosting in Europe, for example.

A full list of valid S3 regions is available from the AWS documentation website.