Ruby on Rails - File Uploading


You may have a requirement in which you want your site visitors to upload a file on your server. Rails makes it very easy to handle this requirement. Now we will proceed with a simple and small Rails project.

As usual, let's start off with a new Rails application called testfile. Let's create the basic structure of the application by using simple rails command.

C:\ruby> rails new testfile

Before starting application development,we should install gem files as shown below

gem install carrierwave
gem install bootstrap-sass

open up your gemfile and add the following 2 gems at the bottom as shown below image

After add gems in gem file. We need to run commands on console as shown below

bundle install

Creating the Model

We need to create a model with two strings as name and attachment as shown below

rails g model Resume name:string attachment:string

We need to create the database migration as shown below

rake db:migrate

We need to generate the controller as shown below

rails g controller Resumes index new create destroy

Great! Now we have the basic structure set up. Now we need to create an uploader.An Uploader came from carrierwave gem and it tells to carrierwave,how to handle the files. In short, it contained all file processing functionalities.Run the command to create an uploader as shown below

rails g uploader attachment

Now open the resume model and call the uploader as shown below.Resume model has placed at app/models/resume.rb:

class Resume < ActiveRecord::Base
  mount_uploader :attachment, AttachmentUploader # Tells rails to use this uploader for this model.
  validates :name, presence: true # Make sure the owner's name is present.

Before working on controller, we need to modify our config/routes.db as shown below

CarrierWaveExample::Application.routes.draw do
  resources :resumes, only: [:index, :new, :create, :destroy]
  root "resumes#index"

Lets edit the controller as shown below.

class ResumesController < ApplicationController
  def index
    @resumes = Resume.all

  def new
    @resume =

  def create
    @resume =

      redirect_to resumes_path, notice: "The resume #{} has been uploaded."
      render "new"

  def destroy
    @resume = Resume.find(params[:id])
    redirect_to resumes_path, notice:  "The resume #{} has been deleted."

  def resume_params
    params.require(:resume).permit(:name, :attachment)

Let's add bootstrap implementation in css file.css file could be in app/assets/stylesheets/resumes.css.scss

@import "bootstrap";

Now open up app/views/layouts/application.html.erb and add codes as shown below

<!DOCTYPE html>
  <%= stylesheet_link_tag    "application", media: "all", "data-turbolinks-track" => true %>
 <%= javascript_include_tag "application", "data-turbolinks-track" => true %>
  <%= csrf_meta_tags %>
<div class="container" style="padding-top:20px;">
<%= yield %>

Now we need to set up index views as shown below

<% if !flash[:notice].blank? %>
  <div class="alert alert-info">
  <%= flash[:notice] %>
<% end %>
<br />
<%= link_to "New Resume", new_resume_path, class: "btn btn-primary" %>
<br />
<br />
<table class="table table-bordered table-striped">
      <th>Download Link</th>
      <th> </th>
    <% @resumes.each do |resume| %>
        <td><%= %></td>
        <td><%= link_to "Download Resume", resume.attachment_url %></td>
        <td><%= button_to "Delete",  resume, method: :delete, class: "btn btn-danger", confirm: "Are you sure that you wish to delete #{}?" %></td>
    <% end %>

Now, lets edit new.html.erb and add our form code.

<% if !@resume.errors.empty? %>
  <div class="alert alert-error">
      <% @resume.errors.full_messages.each do |msg| %>
        <li><%= msg %></li>
      <% end %>
<% end %>

<div class="well">
  <%= form_for @resume, html: { multipart: true } do |f| %>
    <%= f.label :name %>
    <%= f.text_field :name %>
    <%= f.label :attachment %>
    <%= f.file_field :attachment %>
    <%= f.submit "Save", class: "btn btn-primary" %>
  <% end %>

Now start the server and visit http://localhost:3000.It will produce a screen similar to as follows

One last thing we need to do is filter the list of allowed filetypes,For that we need add simple code as shown below at app/uploaders/attachment_uploader.rb

class AttachmentUploader < CarrierWave::Uploader::Base
  storage :file

  def store_dir

  def extension_white_list
    %w(pdf doc htm html docx)

Now start the server and visit http://localhost:3000,Now give wrong formate, it will generates a wrong message as shown below

For a complete detail on File object, you need to go through the Ruby Reference Manual.