What is Dotkernel Admin?
Dotkernel Admin lives in its own separate repository and is a fully-functional, independent application. It's built on top of the same Mezzio + Laminas foundation as Dotkernel API, and comes with a built-in UI including authentication, user management and a web interface.
Installation
- Clone the repository into your folder of choice:
git clone https://github.com/dotkernel/admin.git . - Follow the step-by-step installation guide to configure the database credentials and run the migrations and fixtures that create and populate the database. This takes only a few minutes and results in a ready-to-use admin panel.
Make sure to change the default credentials when in production.
Features & Architecture
Dotkernel Admin comes with several useful features out of the box:
- Role-Based Access Control using dot-rbac and dot-rbac-guard to manage permissions, routes and handler-level security.
- OpenAPI annotations included in each module via
OpenAPI.php, making admin endpoints documented and testable. - Frontend tooling using Twig and NodeJS/NPM for client-side assets, including
buildandwatchscripts to manage JavaScript/CSS bundling.
The file architecture features a modular design with several functional modules:
| Module | Responsibility |
|---|---|
| Admin module | Manages administrator users |
| App module | Houses core functions like authentication and error reporting |
| Setting module | Stores and manages display or application settings for various report pages |
How They Work Together
- The REST API is designed to serve JSON endpoints for clients, services and mobile apps alike.
- The Admin UI is a web-based interface that communicates with the database via its own endpoints to manage data, users and settings.
One of the greatest benefits to using both Dotkernel API and Admin is the unified tech stack.
Both use the Mezzio microframework, Laminas components, Doctrine ORM for database storage and object mapping, PHP FIG's PSR standards, and share modules like authentication and dot-rbac.
Put together, these ensure consistency across backend and admin tooling, while also making it easier to switch between developing one or the other. The similar architecture normally means fewer developers are needed to manage the codebases.
Summary
Dotkernel Admin is a complementary admin panel that provides effective reporting out of the box and is a good starting point for admin requirements. It's not bundled by default, but is provided as a first-party, installable package designed to work seamlessly alongside the API.
Together, the two applications form a cohesive system: you normally start with the API backend and add the rich administrative interface to complete your admin platform. Both are built with the same underlying file architecture and implement the same PHP standards - PSR-7 (HTTP messages) and PSR-15 (middleware).
Benefits of both components:
- Fully open-source and in active development.
- Highly configurable to suit exact requirements.
- Guarantee a future-proof system using the best practices recommended by the PHP community.
Frequently Asked Questions
What is Dotkernel Admin? +
Dotkernel Admin is a fully-functional, independent application that lives in its own separate repository. It's built on the same Mezzio + Laminas foundation as Dotkernel API and includes a built-in UI with authentication, user management and a web interface.
How do I install Dotkernel Admin? +
Install it via Git into the folder of your choice with `git clone https://github.com/dotkernel/admin.git .`, then follow the step-by-step installation guide to configure the database credentials and run the migrations and fixtures that create and populate the database. Be sure to change the default credentials before going to production.
What features does Dotkernel Admin include out of the box? +
It ships with Role-Based Access Control powered by dot-rbac and dot-rbac-guard to manage permissions, routes and handler-level security; OpenAPI annotations in each module for documented and testable admin endpoints; and frontend tooling built on Twig and NodeJS/NPM, including build and watch scripts for JavaScript/CSS bundling.
What modules make up Dotkernel Admin's architecture? +
The file architecture is modular, featuring an Admin module that manages administrator users, an App module that houses core functions like authentication and error reporting, and a Setting module that stores and manages display or application settings for various report pages.
How do Dotkernel API and Admin work together? +
The REST API serves JSON endpoints for clients, services and mobile apps, while the Admin UI is a web-based interface that communicates with the database via its own endpoints to manage data, users and settings. Both share a unified tech stack - Mezzio, Laminas components, Doctrine ORM and PHP FIG's PSR standards - plus shared modules like authentication and dot-rbac, which keeps backend and admin tooling consistent and lets fewer developers manage both codebases.