Chapter 2. Using Admin Tools

Table of Contents

The Control Panel
The component Options
Fixing the permissions of files and directories
Configuring the permissions of files and directories
Emergency Off-Line Mode
Protect your administrator back-end with a password
The .htaccess maker
Basic Security
Server protection
How to determine which exceptions are required
Custom .htaccess rules
Optimisation and utility
System configuration
The NginX configuration maker
Basic Security
Server protection
How to determine which exceptions are required
The Kitchen Sink (Expert Settings)
Optimisation and utility
System configuration
The web.config maker
Basic Security
Server protection
How to determine which exceptions are required
Optimisation and utility
System configuration
Web Application Firewall
Basic Features
Request Filtering
Hardening Options
Project Honeypot
Logging & reporting
Troubleshooting (I got locked out of my site)
WAF Exceptions
WAF Blacklist
Administrator IP Whitelist
Site IP Blacklist
Anti-spam Bad Words
Geographic blocking
Security Exceptions Log
List of blocking reasons
Auto IP Blocking Administration
Auto IP Blocking History
Email templates
Database tools
The PHP File Scanner
How does it work and what should I know?
Scanning and administering scans
Reading the reports
Automating the scans (CRON jobs)
Automating the scans (front-end scheduling URL)
SEO and Link Tools
URL Redirection
Cleaning your temporary files directory
Protecting Admin Tools with a password
Import and Exporting Settings
Access Control
The "System - Admin Tools" plugin
Rescue Mode
Other plugins
The plugins powering the One Click Update feature
The CLI update notification and automatic update script

The Control Panel

The main page of the component which gives you access to all of its functions is called the Control Panel.

The Control Panel page

The Control Panel is split in three areas, a top area, the left-hand control panel icons and the right-hand information boxes.

If there is an update available, you will see the information about it at the very top of the page. Click on the Update button to go to the Joomla! extensions update page where you can install the update.

The top area displays information about the Geographic IP (GeoIP) database. Please read on towards the bottom of this section for more information.

In the left hand area you have icons which launch the individual tools out of which Admin Tools is made when clicked. Each of those tools is described in a section of its own in the rest of this documentation.

Clicking on the Scheduling (via plugin) button will launch the System - Admin Tools plugin configuration page in a pop-up dialog box. In there, you can configure the scheduling options for Admin Tools' utilities. Do note that this feature is only available in the Professional edition.

The topmost right hand information pane displays the Admin Tools version information. You can see the version of the software, as well as force-reload the update information for Admin Tools itself. The latter is only necessary if there was an update released in the last 24 hours and your copy of Admin Tools has not "seen" it yet.

Below that you will see the graphs showing the number of logged security exceptions (attacks Admin Tools Professional has protected you against), their distributions by type and a few statistics about them, e.g. how many exceptions have occurred in the last year, month, week, day and so on.

What is the GeoIP database, installing and updating it


This product includes GeoLite2 data created by MaxMind, available from MaxMind. This is only required by the Professional version of the component.

Certain features in Admin Tools require it to be able to find out the country and / or continent associated with the IP address of a visitor of your site. This is used to provide country information on blocked requests, as well as the Geographic IP Block feature. Naturally, IPs do not carry geographic information so we need an external database which has this kind of information.

Admin Tools requires you to install an optional plugin called "System - Akeeba GeoIP provider plugin". You can download it for free from our site. Please remember to enable it after you install it.

This plugin is using the third party MaxMind GeoLite2 database to match IPs to countries and continents. This list is not static, i.e. it is updated about once per month. Admin Tools can attempt to download its newest version by clicking the Update the GeoLite2 Country database button in the Control Panel page. However, if this is not possible (for reasons ranging from your host restrictions to permissions issues) you can do so manually.

You can download the latest version of MaxMing GeoLite2 database in binary format, from Extract the downloaded compressed file using gunzip on Linux, 7-Zip on Windows or BetterZIP on Mac OS X. It will result in a file named GeoLite2-Country.mmdb. Upload it to your site's plugins/system/akgeoip/db directory overwriting the existing file.


Capitalization matters! You have to upload the file as GeoLite2-Country.mmdb.gz, not geolite2-country.mmdb.gz or any other combination of lowercase / capital letters, otherwise IT WILL NOT WORK, AT ALL.


If you are a subscriber to MaxMind's more accurate (99.8% advertised accuracy), for-a-fee GeoIP Country database you can use that database instead of the free GeoLite2 database included in the component, using the same procedure.

Do note that security exception log records prior to installing the new version of the database will not be affected. Only security exceptions logged after uploading the new database version will be affected by the new database version.

Cookies Notification - Action required

This website uses cookies to provide user authentication and improve your user experience. Please indicate whether you consent to our site placing these cookies on your device. You can change your preference later, from the controls which will be made available to you at the bottom of every page of our site.