Contents

---
redirect_from: /docs/documentation.html
---

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.

# Getting Started

Active Admin is released as a Ruby Gem. The gem is to be installed within a Ruby
on Rails application. To install, simply add the following to your Gemfile:

```ruby
# Gemfile
gem 'activeadmin'
```

After updating your bundle, run the installer

```bash
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:

```bash
$> rake db:migrate
$> rails server
```

Visit `http://localhost:3000/admin` and log in using:

* __User__: [e-mail]
* __Password__: password

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

To register your first model, run:

```bash
$> 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.

# Next Steps

Now that you have a working Active Admin installation, learn how to customize it:

* [Customize the Index Page](3-index-pages.md)
* [Customize the New and Edit Form](5-forms.md)
* [Customize the Show Page](6-show-pages.md)
* [Customize the Resource in General](2-resource-customization.md)

Version data entries

26 entries across 26 versions & 3 rubygems

Version	Path
activeadmin-rb-1.6.0	docs/documentation.md
activeadmin-rb-1.5.2	docs/documentation.md
activeadmin-rb-1.5.1	docs/documentation.md
activeadmin-2.6.1	docs/documentation.md
activeadmin-2.6.0	docs/documentation.md
activeadmin-2.5.0	docs/documentation.md
activeadmin-2.4.0	docs/documentation.md
activeadmin-2.3.1	docs/documentation.md
activeadmin-2.3.0	docs/documentation.md
activeadmin-2.2.0	docs/documentation.md
activeadmin-2.1.0	docs/documentation.md
activeadmin-2.0.0	docs/documentation.md
activeadmin-rb-1.5.0	docs/documentation.md
activeadmin-2.0.0.rc2	docs/documentation.md
activeadmin_addons-1.7.1	vendor/bundle/ruby/2.3.0/bundler/gems/activeadmin-f71b375325eb/docs/documentation.md
activeadmin-2.0.0.rc1	docs/documentation.md
activeadmin_addons-1.7.0	vendor/bundle/ruby/2.3.0/bundler/gems/activeadmin-f71b375325eb/docs/documentation.md
activeadmin-1.4.3	docs/documentation.md
activeadmin-1.4.2	docs/documentation.md
activeadmin-1.4.1	docs/documentation.md