Skip to content
Josh McArthur edited this page May 14, 2020 · 224 revisions


Please feel free to add more information, helpful links, how-tos, etc. Thank you!

Getting help

If you have a question about CarrierWave, please search the Wiki and Google Group to see if your question has already been answered. If it has not been discussed previously, please post your question to the Google Group.

Please review the Known issues wiki page for common problems that you may encounter.

Before reporting an issue, please ensure you are using latest CarrierWave version. Check the History.txt file to see if your issue has already been solved but not yet released in the gem version. Search the existing GitHub Issues to make sure your issue hasn’t already been discussed. If you think you’ve found a security bug, do NOT use the GitHub Issue tracker. Please send a private GitHub message to “jnicklas” instead.

When reporting an issue, please include the version information for all software involved. This would include the version of Ruby, Rails, Sinatra, etc that you are using. Include the error class, error message and backtrace if you are getting an error. Please provide this information in a Gist on GitHub instead of within the issue itself. Simply pasting in a heap of code into an issue is generally not helpful because it can be very difficult to read. It can also be extremely helpful if you try to isolate the bug in a small application and push it to github. You can use the small Sinatra application here as a base.

Please remember that this is an open-source project, and the contributions of volunteers have made it possible. Please be polite when asking for help, and provide as much information as possible so that others can help you more easily.

If you’re experienced with Ruby, please try to reproduce the bug in the test suite. If you think you can fix the issue, pull requests with tests are always welcome. Again, remember that this is an open-source project, and the contributions of volunteers have made it possible. Please consider becoming a contributor!


Railscasts – CarrierWave File Uploads

Example applications

Rails 2.3.5 example by jnicklas
Carrierwave, DataMapper, & Sinatra starring in ‘Imagine the Possibilities’ by foysavas
Multiple file uploads with Ajax, Carrierwave, & Mongoid
Multiple Images Uploading With CarrierWave and PostgreSQL Array


Link Description
carrierwave-audio SoX audio file compression and watermarking
carrierwave-unoconv LibreOffice conversion support via unoconv
carrierwave-imagesorcery ImageSorcery support
carrierwave-datamapper Datamapper support
carrierwave-mongoid Mongoid and GridFS support
carrierwave-sequel Sequel support
carriercouch CouchDB support
mm-carrierwave Mongo Mapper support
carrierwave_backgrounder Background processing support with Delayed Job, Resque, GirlFriday, Qu or Sidekiq
carrierwave-orm-mongoo Mongoo support
carrierwave-neo4j Neo4j support
carrierwave-neo4j-data-uri Carrierwave Neo4j plugin that allows to create image from data uri
carrierwave-aws An aws-sdk based storage alternative to Fog
carrierwave-meta File’s metadata saving plugin for carrierwave
carrierwave_direct Process your uploads in the background by uploading directly to S3
carrierwave-upyun Yupoo UpYun storage for CarrierWave
carrierwave-aliyun Aliyun OSS storage for CarrierWave
carrierwave-riak Riak Support
carrierwave-processing Additional processing support for MiniMagick and RMagick
carrierwave-vips Support for the VIPS image processing library, a fast and resource-efficient alternative to RMagick
carrierwave-daltonize Adds daltonize processing to carrierwave (using carrierwave-vips)
carrierwave-qiniu Qiniu storage support for CarrierWave
video_thumbnailer A plugin that generate thumbnail for the videos uploaded in the application.
carrierwave-ftp FTP storage support
carrierwave-video-thumbnailer Makes thumbnails for your videos
carrierwave-serializable Allows mount uploader to serialized field
carrierwave-imageoptimizer Image optimization support for .jpeg, .gif, and .png formats
carrierwave-viewer Preview .doc, .ppt and .pdf docs with
carrierwave-cascade Retrieve file from a secondary storage when the file is not in the primary storage.
carrierwave-webdav WebDAV storage for carrierwave
carrierwave-dropbox Dropbox storage for CarrierWave.
carrierwave-mimetype-fu Automatically check content_type on upload and set proper file extension
carrierwave-encrypter-decrypter Secure your uploaded files on server
newrelic-carrierwave Adds carrierwave instrumentation for NewRelic (supports RMagick, MiniMagick, and VIPS).
carrierwave-truevault Adds TrueVault storage for CarrierWave.
ianyamey/carrierwave-truevault An alternative TrueVault add-on, using RestClient.
carrierwave-sharefile Adds ShareFile storage for CarrierWave.
carrierwave-data-uri Plugin that allows create image from data uri
carrierwave-base64 Another plugin that handles uploads from data uri encoded as base64
carrierwave-bombshelter A plugin to protect your uploaders from image bombs (such as specifically crafted PNGs that will cause OOM errors when processed by ImageMagick)
carrierwave-jpegtran JPEG optimization using jpegtran or MozJPEG.
metaware/carrierwave-google-storage Carrierwave Google Storage adapter that relies on the official `gcloud` library instead of Fog.
carrierwave-attachmentscanner Scan Carrierwave uploads for viruses and malware (third party service).
carrierwave-i18n Provides additional locales for CarrierWave, the classier solution for file uploads for Rails.


How to: Easy Ajax file uploads with Remotipart
How to: Secure Upload
How to: Migrate to the new Fog storage provider
How to: Validate uploads with Active Record
How to: Make Carrierwave work on Heroku
How to: Store the uploaded file size and content type
How to: Specify the image quality
How to: Detect a new file in a mounted uploader
How to: Create random and unique filenames for all versioned files
How to: Use a timestamp in file names
How to: Do conditional processing
How to: Use test fixtures
How to: Test Fog based uploaders
How to: Delete cache garbage directories
How to: Tracking Dirty State
How to: Upload from a string in Rails 3 or later
How to: "Upload" from a local file
How to: Make a fast lookup able storage directory structure
How to: Validate image file size
How to: Cleanup after your Rspec tests
How to: Cleanup original file that wasn't uploaded like as Tempfile
How to: Customize your version file names
How to: Use CarrierWave with Rails 2.3.x
How to: Move version name to end of filename, instead of front
How to: Silently ignore missing files on destroy or overwrite
How to: Use CarrierWave with Devise
How to: Use Rackspace ServiceNet (snet) to transfer from CloudServer to CloudFiles
How to: Dynamically set storage type
How to: Use Callbacks
How to: Get version image dimensions
How to: Keep uploaded files (for a specific uploader)
How to: Make CarrierWave work with Padrino
How to: Create a thumbnail with both color and grayscale versions in one image
How to: Store private/public uploads in different Cloud Files Containers with Fog
How to: Recreate and reprocess your files stored on fog
How to: Store same file on same place, but different record
How to: Migrate from paperclip to carrierwave (example thor task)
How to: Making uploads work across form redisplays with accept_nested_attributes_for
How to: Efficiently converting image formats
How to: Define different storage configuration for each Uploader.
How to: Ensure file uniqueness.
How to: Prevent CarrierWave from locking the DB row of your object while it's processing the image attached to that object
How to: Keep (not replace) files on nested edits
How to: use with PaperTrail
How to: Add more files and remove single file when using default multiple file uploads feature
How to: Secure uploaded file in S3 and make it only accessible by supplying secret token?
How to: Use minio with Carrierwave
How to: Add, remove and reorder images using multiple file upload
How to: Set the content type using the UNIX file utility

Blog posts

Functional tests with Carrierwave
How to use Delayed Job to handle your Carrierwave processing => 404
Migrating from attachment_fu to CarrierWave => 404
File Uploads with Rails 3, Plupload, and CarrierWave
Full Control over Changing (S3) Upload Path Name
CarrierWave and Ruby 1.9.2 and Other Tips => 404
Saving Best Image Geometry
Mocking Fog when using it with Carrierwave => 404
Extract Geolocation Image EXIF Data using RMagick on Heroku => 404
Custom RSpec be_square matcher for CarrierWave
A Gentle Introduction to CarrierWave
Recreating a single version of an uploaded file
Video Encoding with Uploadify, CarrierWave and Zencoder
Video encoding processor for CarrierWave
Multiply files upload with nested_attributes Step-by-step tutorial
Getting image data from a CarrierWave Uploader into RMagick, without manipulate!
Processing images with CarrierWave
Multiple Images Uploading With CarrierWave and PostgreSQL Array
Rails 5 and CarrierWave

Add watermark

Clone this wiki locally
You can’t perform that action at this time.