The Administration Panel plugin for Grav is a web GUI (graphical user interface) that provides a convenient way to configure Grav and easily create and modify pages. This will remain a totally optional plugin, and is not in any way required or needed to use Grav effectively. In fact, the admin interface provides an intentionally limited view to ensure it remains easy to use and not overwhelming. Power users will still prefer to work with the configuration files directly.
The Adminstration Panel is quite an ambitious plugin with lots of functionality that will give you a lot of power and flexibility when building out your Grav sites. So if you have any questions, problems, suggestions or find one of those rare bugs in it, please use one of the following ways to get support from us.
For live chatting, please use the Discord Chat Server for discussions related to the admin plugin.
For bugs, features, improvements, please ensure you create issues in the admin plugin GitHub repository.
First ensure you are running the latest Grav version, 1.7.28 or later. This is required for the admin plugin to run properly. Check for and upgrade to new Grav versions like this (
-f forces a refresh of the GPM index):
bin/gpm version -f bin/gpm selfupgrade
The admin plugin actually requires the help of 3 other plugins, so to get the admin plugin to work you first need to install the login, forms, and email plugins. These are available via GPM, and because the plugin has dependencies you just need to proceed and install the admin plugin, and agree when prompted to install the others:
bin/gpm install admin
You can also install the plugin manually if you are unable to use GPM on your system.
With the latest version of the Admin, you will be prompted to create an admin user account when you point your browser to your site. You must complete this step to ensure straight away a valid admin user is under your control.
Simply fill out the form and click the
Create User button.
The user information is stored in the
user/accounts/ folder of your Grav installation. You can edit the values manually or via the Admin plugin itself. You can also create new users manually or via the
bin/plugin login newuser CLI command. More information is contained in the Admin FAQ.
Regex patterns for usernames and passwords are defined in
The default pattern for users (
system.username_regex) is only lowercase characters, digits, dashes, and underscores. Usernames must be between 3 - 16 characters in length.
The default pattern for passwords (
system.pwd_regex) is a minimum of eight (8) characters, with at least one number, one uppercase, and one lowercase letter.
By default, you can access the admin by pointing your browser to
http://yoursite.com/admin. You can simply log in with the
password set in the YAML file you configured earlier.
After logging in, your plaintext password will be removed and replaced by an encrypted one.
Found errors? Think you can improve this documentation? Simply click the Edit link at the top of the page, and then the icon on Github to make your changes.