https://github.com/ddev/ddev-adminer
Adminer web-based MySQL, MariaDB, PostgreSQL database browser for DDEV
https://github.com/ddev/ddev-adminer
ddev-get
Last synced: 5 months ago
JSON representation
Adminer web-based MySQL, MariaDB, PostgreSQL database browser for DDEV
- Host: GitHub
- URL: https://github.com/ddev/ddev-adminer
- Owner: ddev
- License: apache-2.0
- Created: 2022-03-11T13:36:22.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2026-01-20T17:50:33.000Z (5 months ago)
- Last Synced: 2026-01-21T02:40:31.969Z (5 months ago)
- Topics: ddev-get
- Language: Shell
- Homepage:
- Size: 152 KB
- Stars: 17
- Watchers: 4
- Forks: 8
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://addons.ddev.com)
[](https://github.com/ddev/ddev-adminer/actions/workflows/tests.yml?query=branch%3Amain)
[](https://github.com/ddev/ddev-adminer/commits)
[](https://github.com/ddev/ddev-adminer/releases/latest)
# DDEV Adminer
## Overview
[Adminer](https://www.adminer.org/) is a full-featured database management tool written in PHP.
This add-on integrates Adminer into your [DDEV](https://ddev.com/) project.
Adminer works with MySQL, MariaDB, PostgreSQL, SQLite, MS SQL, Oracle, and MongoDB.
## Installation
```bash
ddev add-on get ddev/ddev-adminer
ddev restart
```
After installation, make sure to commit the `.ddev` directory to version control.
## Usage
| Command | Description |
| ------- | ----------- |
| `ddev adminer` | Open Adminer in your browser (`https://.ddev.site:9101`) |
| `ddev describe` | View service status and used ports for Adminer |
| `ddev logs -s adminer` | Check Adminer logs |
### SQLite
When connecting to an SQLite database, the project files are available under the `/mnt/ddev_app` mount, in the example below, `test.sqlite` is located in the project root:
```bash
ddev dotenv set .ddev/.env.adminer \
--adminer-default-driver=sqlite \
--adminer-default-username="" \
--adminer-default-password="" \
--adminer-default-server="" \
--adminer-default-db=/mnt/ddev_app/test.sqlite
```
Make sure the owner of the SQLite database file is the same as the user which adminer is running as.
## Advanced Customization
To change the design:
```bash
# design: https://www.adminer.org/en/#extras
ddev dotenv set .ddev/.env.adminer --adminer-design=dracula
ddev add-on get ddev/ddev-adminer
ddev restart
```
Make sure to commit the `.ddev/.env.adminer` file to version control.
To add more plugins:
```bash
# plugins: https://www.adminer.org/en/plugins/
ddev dotenv set .ddev/.env.adminer --adminer-plugins="ddev-passwordless-login tables-filter edit-calendar"
ddev add-on get ddev/ddev-adminer
ddev restart
```
If a plugin *requires* parameters, refer to the [official documentation](https://hub.docker.com/_/adminer) for more details.
For user-contributed plugins, see [example](https://github.com/ddev/ddev-adminer/issues/43).
Make sure to commit the `.ddev/.env.adminer` file to version control.
All customization options (use with caution):
| Variable | Flag | Default |
| -------- | ---- | ------- |
| `ADMINER_DEFAULT_DB` | `--adminer-default-db` | `db` |
| `ADMINER_DEFAULT_DRIVER` | `--adminer-default-driver` | `server` |
| `ADMINER_DEFAULT_PASSWORD` | `--adminer-default-password` | `db` |
| `ADMINER_DEFAULT_USERNAME` | `--adminer-default-username` | `db` |
| `ADMINER_DESIGN` | `--adminer-design` | `` |
| `ADMINER_DOCKER_IMAGE` | `--adminer-docker-image` | `adminer:standalone` |
| `ADMINER_PLUGINS` | `--adminer-plugins` | `ddev-passwordless-login tables-filter` |
## Credits
**Contributed by [@bserem](https://github.com/bserem)**
**Maintained by the [DDEV team](https://ddev.com/support-ddev/)**