Installing Devise in a mountable engine is nearly identical to installing Devise in an application. However, there are a few additional configuration options that need to be adjusted.
It's not possible to mount Devise multiple times (related issue w/ a possible workaround). For instance, if you have a main Rails app called
A which mounts an engine
B, you can't have Devise mounted for both
config/initializer/devise.rb will be overwritten by
B, which breaks options like
Installing Devise in an engine follows the same steps as the general installation instructions, but we'll be running the commands from our engine's directory and benefiting from the namespaced
rails helper there.
Add Devise to the engine's dependencies in your gemspec:
Gem::Specification.new do |s| s.add_dependency "devise" end
Generate the config files:
rails generate devise:install
And generate a model if you need to:
rails generate devise MODEL
You'll need to direct Devise to use your engine's router. To do this, set
config/initializers/devise.rb. It should be a symbol containing the name of the mountable engine's named-route set. For example, if your engine is namespaced as
Devise.setup do |config| config.router_name = :my_engine end
Your user class is probably namespaced, so you'll need to pass that to the Devise helper in
MyEngine::Engine.routes.draw do devise_for :users, class_name: "MyEngine::User" end
If your engine uses
isolate_namespace, Devise will assume that all of its controllers reside in your engine rather than Devise. To correct this, add
:module => :devise to the routes helper:
MyEngine::Engine.routes.draw do devise_for :users, class_name: "MyEngine::User", module: :devise end
You probably want Devise's controllers to inherit from your engine's controller and not the main controller. Set this in
Devise.setup do |config| config.parent_controller = 'MyEngine::ApplicationController' end
Finally, you'll need to require Devise in your engine. Add the following line to
You can also set the layout for specific Devise controllers using a callback in
module MyEngine class Engine < ::Rails::Engine config.to_prepare do Devise::SessionsController.layout "layout_for_sessions_controller" end end end
NOTE: If you need to override the standard devise views (i.e. app/views/devise/sessions/new) you will want to require 'devise' before you require your engine. This way the view order will get configured appropriately and you can manage the overrides within your engine rather than the main app.
Any code that gets run from the context of a Devise controller (controllers, helpers, and views) may require using "fully-qualified" path helpers, e.g.
my_engine.root_path. The path helpers defined by Devise don't need this. I'm not sure if this is a bug.
http://github.com/BrucePerens/perens-instant-user/ is an example Rails Engine that adds Devise to the application while keeping most of the complexity of using Devise in the engine rather than your application.
It contains pre-defined mountable routes for Devise, and a pre-defined User model. Its installation steps are easier than those of stand-alone Devise. Unlike stand-alone Devise, you aren't advised to become a Ruby Wizard before installing it :-)
There is an issue with using Devise's Omniauth integration in an embedded engine. See this issue for workarounds.