# Database Management

> Inspect database health, run migrations, and manage utilities

## Identity

| Field | Value |
| --- | --- |
| Route | `/admin/databases/management` |
| Area | admin |
| Audience | Panel administrators (requires admin permissions) |
| Component | `DatabaseManagementPage` |
| Source | `src/app/(app)/admin/databases/management/page.tsx` |
| Dynamic | no |

| Title i18n key | `admin.database_management.title` |
| Description i18n key | `admin.database_management.subtitle` |
| Permission | `admin.databases.view` |
| Nav group | `infrastructure` |
| Sidebar label | Database Management |

## Summary (for AI)

**Database Management** Inspect database health, run migrations, and manage utilities Requires permission `admin.databases.view`. Key UI: Failed to fetch database status; Migrations completed successfully; Migration failed; phpMyAdmin is already installed; phpMyAdmin installed successfully; Are you sure you want to delete phpMyAdmin? This action cannot be undone..

## How to guide users

1. Open Admin sidebar.
2. Go to **Database Management**.
3. Direct URL: `/admin/databases/management`.
4. User needs permission `admin.databases.view` (or `admin.root`).

## Sections on this page

- Migration Output
- What is this page?

## Notable UI actions / labels

- Failed to fetch database status
- Migrations completed successfully
- Migration failed
- phpMyAdmin is already installed
- phpMyAdmin installed successfully
- Are you sure you want to delete phpMyAdmin? This action cannot be undone.
- phpMyAdmin deleted successfully
- Refresh Status
- Run Migrations
- Delete phpMyAdmin
- Install phpMyAdmin
- Overview

## Widget slugs

- [`admin-databases-management`](../widgets/admin-databases-management.md)

## Related APIs / hooks

- `/api/admin/databases/management/install-phpmyadmin`
- `/api/admin/databases/management/migrate`
- `/api/admin/databases/management/phpmyadmin`
- `/api/admin/databases/management/phpmyadmin/status`
- `/api/admin/databases/management/status`

Hooks: `usePluginWidgets`