Skip to content
The administration framework for Ruby on Rails applications.
Ruby CoffeeScript JavaScript
Pull request Compare This branch is 12 commits ahead, 2200 commits behind activeadmin:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Active Admin

Active Admin is a framework for creating administration style interfaces. It abstracts common business application patterns to make it simple for developers to implement beautiful and elegant interfaces with very little effort.

Documentation & Support


  1. Allow developers to quickly create gorgeous administration interfaces (Not Just CRUD)

  2. Build a DSL for developers and an interface for businesses.

  3. Ensure that developers can easily customize every nook and cranny of the interface.

  4. Build common interfaces as shareable gems so that the entire community benefits.

Bugs Reports & Contributing

Feature Requests

Please don't put feature requests in Github Issues. They will be closed as soon as they are reviewed by one of the core team members. If you would like a feature in Active Admin, please submit a well tested pull request with the desired changes. If you're not a coder, then the mailing list may be a good place to try to convince someone to help you out with your cause.

If you are going to submit a pull request, please read the contributing guide:

Getting Started

Active Admin is released as a Ruby Gem. The gem is to be installed within a Ruby on Rails 3 application.

This is a special branch of ActiveAdmin just for those that are early adopters of Strong Parameters which will be included in Rails 4:

To install it, add the following to your Gemfile:

gem 'activeadmin', git: '', branch: 'rails-3_2-with-strong-parameters'

Note: you don't need to be using this branch just to use ActiveAdmin in Rails 3.2 with Strong Parameters. See the Strong Parameters section for more details.

After updating your bundle, run the installer

$> rails generate active_admin:install

The installer creates an initializer used for configuring defaults used by Active Admin as well as a new folder at app/admin to put all your admin configurations.

Migrate your db and start the server:

$> rake db:migrate
$> rails server

Visit localhost:3000/admin and log in using:

  • User:

  • Password: password

Voila! You're on your brand new Active Admin dashboard.

To register your first model, run:

$> rails generate active_admin:resource [MyModelName]

This creates a file at app/admin/my_model_names.rb for configuring the resource. Refresh your web browser to see the interface.


When upgrading to a new version of ActiveAdmin you may need to run

$> rails generate active_admin:assets

If you get:

uninitialized constant Admin::DashboardController

when trying to view the dashboard (at /admin), ensure app/admin/dashboards.rb looks like the current default.

Next Steps

The best place to get documentation is at

To view a sample Active Admin application, checkout

If you have any questions, please email the mailing list at

Tools Being Used

We believe strongly in not writing code unless we have to, so Active Admin is built using many other open source projects:


Inherited Resources speeds up development by making your controllers inherit all restful actions so you just have to focus on what is important.


A DSL for semantically building amazing forms.


User authentication is done using Devise


Pagination for rails apps

Iconic Icons

Excellent SVG icon set designed by P.J. Onori:

Strong Parameters

In config:

# Whether or not to enforce strong parameters. Default is false, which will call permit!
# on the resource in params in the controller for update and create, if strong_parameters gem is found.
# If true then it will not do that, and the user will need to explicitly define the params to be permitted.
config.enforce_strong_parameters = false

In controller config, optionally specify permitted params:

ActiveAdmin.register Post do
  # Allow static list
  permitted_params :a, :b, :c

  # Conditionally control access at runtime
  permitted_params do
    [:a, :b, :c]


Copyright © 2011 Greg Bell, VersaPay Corporation. See LICENSE for details.

Something went wrong with that request. Please try again.