EasyAdmin creates beautiful backends for Symfony applications. It's free, fast, fully documented, and trusted by tens of thousands of projects.
## Quick Start
In your Symfony application, run these commands:
```bash
composer require easycorp/easyadmin-bundle
php bin/console make:admin:dashboard
php bin/console make:admin:crud
```
Visit `/admin` in your browser. That's it!
📖 **[Read the full documentation →](https://symfony.com/bundles/EasyAdminBundle/current/index.html)**
## Features
| Feature | Description |
| ------- | ----------- |
| 🎨 **Beautiful by Default** | Modern, responsive UI with light and dark modes. No CSS required |
| 👥 **Multiple Dashboards** | Create separate backends for guests, external collaborators, or different user roles |
| ⚡ **CRUD in Minutes** | Generate complete backends from your Doctrine entities with a single command |
| 🔍 **Search, Filters & Pagination** | Powerful built-in tools to find and navigate your data effortlessly |
| 🛡️ **Fine-grained Security** | Control access at dashboard, menu, action, field, and entity level |
| 🎛️ **30+ Field Types** | Text, dates, associations, file uploads, WYSIWYG and code editors, and much more |
| 📐 **Flexible Form Layouts** | Create sophisticated forms with multiple columns, tabs, and fieldsets |
| ⚙️ **Custom Actions** | Add your own buttons, batch operations, and workflows |
| 🌍 **Fully Translatable** | RTL support included. Translations available in 40+ languages |
| 🛠️ **100% Customizable** | Override any template, extend any class, customize everything |
| 🧩 **Symfony Native** | Seamlessly integrated with Symfony forms, security, routing, and more |
| ✅ **Unmatched Compatibility** | Works with Symfony 6.x, 7.x, and 8.x and Doctrine 2.x, 3.x, and 4.x |
## Why EasyAdmin?
- **Trusted by tens of thousands of projects**: One of the most downloaded Symfony bundles ever
- **Battle-tested since 2015**: Mature, stable, and production-ready
- **Maintained by Symfony experts**: 500+ contributors and led by a Symfony Core Team member
- **Zero JavaScript knowledge required**: Build complete backends with PHP only
- **Extensible when you need it**: Customize anything without fighting the framework
## Requirements
- PHP 8.2 or higher
- Symfony 6.4 or higher
- Doctrine ORM entities
### Versions
| Version / Repository Branch | Symfony Compatibility | PHP Compatibility | Status | Docs
| --------------------------- | ----------------------------- | ----------------- | -------------------- | ---
| `5.x` | `6.4`, `7.x` and `8.x` | `8.2` or higher | Stable version | [Read Docs](https://symfony.com/bundles/EasyAdminBundle/5.x/index.html)
| `4.x` | `5.4`, `6.x`, `7.x` and `8.x` | `8.1` or higher | Bug fixes only | [Read Docs](https://symfony.com/bundles/EasyAdminBundle/4.x/index.html)
| `3.x` | `4.4`, and `5.x` | `7.2.5` or higher | No longer maintained | [Read Docs](https://symfony.com/bundles/EasyAdminBundle/3.x/index.html)
| `2.x` | `4.x`, and `5.x` | `7.1.3` or higher | No longer maintained | [Read Docs](https://symfony.com/bundles/EasyAdminBundle/2.x/index.html)
| `1.x` | `2.x`, `3.x` and `4.x` | `5.3.0` or higher | No longer maintained | -
### Dev Environment
EasyAdmin ships a DDEV environment, which allows you to run EasyAdmin in a
Symfony Framework project providing example entities and CRUD Controllers.
**Requirements:**
* [Docker](https://www.docker.com/get-started/)
* [DDEV](https://ddev.com/get-started/)
**Using the environment:**
* Checkout the EasyAdmin git repository and switch in the project directory
* Perform `ddev setup` which starts and provisions the web container
* EasyAdmin is available under the URL: https://easy-admin-bundle.ddev.site
* With `ddev make ` you can execute predefined tasks from [`Makefile`](./Makefile). Examples:
* To update dependencies (Composer and Yarn): `ddev make build`
* To (re-)build frontend assets perform `ddev make build-assets`
* To run unit tests perform `ddev make tests`
## Resources
- 📖 [Official Documentation](https://symfony.com/bundles/EasyAdminBundle/current/index.html)
- 🎬 [SymfonyCasts Video Tutorial](https://symfonycasts.com/screencast/easyadminbundle)
- 🎮 [EasyAdmin Demo](https://github.com/EasyCorp/easyadmin-demo)
- 🐛 [Issue Tracker](https://github.com/EasyCorp/EasyAdminBundle/issues)
## Contributing
EasyAdmin is an open source project. Contributions are welcome and appreciated!
See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
EasyAdmin is developed using PhpStorm, generously provided by JetBrains through their Open Source License Program.
## License
EasyAdmin is released under the [MIT License](LICENSE).
---
EasyAdmin is developed using PhpStorm, generously provided by JetBrains through their Open Source License Program.