Adminium

This add-on is operated by Cluscrive

Full fledged admin interface without touching your app code

Adminium

Last Updated: 19 March 2014

Table of Contents

Adminium provides you with a full fledged administration interface without touching your app code

Adminium listing

No need to install any plugin or library into your app, no need for a specific version of any framework or language. Just connect your database to Adminium and get access to a fully featured administration interface. You can check out the sandbox account to get the feel of it.

Here are a few of the interesting features that Adminium offers on top of the basic CRUD actions :

  • filters and search
  • fields configuration
  • table relationships navigation
  • enum values
  • CSV export
  • validations
  • bulk destroy, bulk edit

You can also add collaborators to your account to give your clients an access (an Access Control List system will be added soon).

The currently supported RDBMS are PostgreSQL and MySQL.

Installing the add-on

Adminium can be installed to a Heroku application via the CLI:

$ heroku addons:add adminium

In order to provide you with an administration interface for your data, Adminium needs to be able to connect to your database. The easiest way to do that is to install and run a plugin for the Heroku command line tool :

$ heroku plugins:install git://github.com/isc/heroku-adminium
$ heroku adminium

The plugin execution will store an encrypted version of the DATABASE_URL of your application in the Adminium database. Your DATABASE_URL is sent using SSL and is never logged in the Adminium application logs. Removing the add-on from your application will delete that info from the Adminium database.

Integration

Adminium doesn’t need to integrate at a code-level and thus isn’t tied to a particular language. It can be used with any app hosted on Heroku, be it Ruby, Node.js, Clojure, Java, Python, or Scala, as long as it makes use of a PostgreSQL or MySQL database.

Once you’ve completed the previous section you’re all set to use the Adminium interface.

Adminium interface

The interface can be accessed via the CLI:

$ heroku addons:open adminium

or by visiting the Heroku apps web interface and selecting the application in question and then selecting Adminium from the add-ons menu.

For more information on using the Adminium interface please see the docs at adminium.io/docs.

Migrating between plans

Use the heroku addons:upgrade command to migrate to a new plan.

$ heroku addons:upgrade adminium:newplan

Removing the add-on

Adminium can be removed via the CLI.

This will destroy your administration configuration data and your DATABASE_URL from Adminium’s database and cannot be undone. It will not affect any data stored in the database accessed via Adminium.

$ heroku addons:remove adminium

Support

All Adminium support and runtime issues should be logged with Heroku Support. Any non-support related issues or product feedback is welcome at adminium.uservoice.com.

Additional resources

Additional resources are available at :