Skip to content
This repository has been archived by the owner on Sep 6, 2023. It is now read-only.



Folders and files

Last commit message
Last commit date

Latest commit



82 Commits

Repository files navigation

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):


The URL from which Adminer should be downloaded.

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.