Skip to content
Switch branches/tags
This branch is 62 commits ahead, 80 commits behind Oefenweb:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Ansible Role: Adminer


An Ansible Role that installs Adminer on almost any computer.


You need to have PHP and MySQL for Adminer to do anything useful. If you have Apache installed, Adminer will add in configuration to make Adminer accessible on any virtualhost at /adminer; set adminer_add_apache_config to false to disable this behavior.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

adminer_install_dir: /opt/adminer

The directory in which Adminer will be downloaded/installed.

adminer_install_filename: adminer.php

The filename for the downloaded Adminer application. If you're managing virtualhosts or server directives manually, it might be simpler to set the document root to your configured adminer_install_dir, and the filename to index.php, so you don't have to enter /adminer.php in the URL to access Adminer.

adminer_symlink_dirs: []

Directories inside which you would like adminer.php symlinked. Can be useful if you just want to toss the script into a docroot and access it at sitename/adminer.php.

adminer_add_apache_config: false

Set this to true to tell Adminer to add a config file to Apache so you can access it at hostname/adminer on any configured virtualhost, using an Apache Alias directive. The role will also restart Apache so this configuration takes effect immediately.

adminer_theme: ''

You can use any theme from adminer library (for example pappu687). You can find the full list here.


None. If adminer_add_apache_config is set to true, it will use some variables and handlers defined by the geerlingguy.apache role, so there's a soft dependency on that role.

Example Playbook

- hosts: servers
    - { role: geerlingguy.adminer }



Author Information

This role was created in 2015 by Jeff Geerling, author of Ansible for DevOps. It is originally a fork of Oefenweb/ansible-adminer.