Check out the video tutorial below, or read on for the written instructions on how to install GeoIP, how to update it when a new version is released, as well as how to uninstall it.

Installing

Just like any Joomla extension, you can install GeoIP by using the core Joomla Installer available in the Joomla! Administrator Control Panel. Alternatively, you can also use the dedicated Regular Labs Extension Manager.

Install from Web

To install GeoIP via the Joomla! Extension Manager, simply follow these steps:

  1. Log into your Joomla 3 administrator
  2. In the menu, choose: Extensions >> Manage >> Install
  3. Choose the tab: Install from Web (or enable it if you haven't done so yet)
  4. Select the search field and enter GeoIP and hit enter
  5. Click on the GeoIP listing
  6. Click on Install
  7. Click on Install again to confirm

Upload Package File

if you need to install the Pro version, or you cannot install via the 'Install via Web' method for some reason:

  1. Download the install file of GeoIP from the Regular Labs website (.zip)
  2. Log into your Joomla 3 administrator
  3. In the menu, choose: Extensions >> Manage >> Install
  4. Choose the tab: Upload Package File
  5. Click on the Choose File button
  6. Select the package file you downloaded earlier
  7. The upload and install will begin automatically

If you have problems installing GeoIP, please try the manual installation process as described here: docs.joomla.org/Installing_an_extension

Regular Labs Extension Manager

It is very easy to install/update any Regular Labs Extension using the Regular Labs Extension Manager. This is especially useful if you are using more than one Regular Labs extension, or if you've purchased a Pro version.

With the Regular Labs Extension Manager, you can just click on the Install button for GeoIP, and it will install automatically.

To install a Pro extension through the Regular Labs Extension Manager, you need to enter your ‘Download Key” in the Configuration Options of your Regular Labs Extension Manager.

Please see the Regular Labs Extension Manager page for more detailed information.

Updating

When a new version is released, you can simply update the free version of GeoIP via the Joomla Updater.

When updating GeoIP, you don't need to uninstall it first. The new package will update all the files automatically and will preserve your settings.

Note: Keep in mind that when you update to a major new version (or uninstall first), you might lose some configuration settings.

Uninstalling

To uninstall GeoIP, follow these steps:

  1. Log into your Joomla 3 administrator
  2. In the menu, choose: Extensions >> Manage >> Manage
  3. Select the search field and enter GeoIP and hit enter
  4. Select the related GeoIP plugins
  5. Click on Uninstall
  6. Click on OK to confirm

You can also use the Regular Labs Extension Manager to uninstall GeoIP, by clicking the red X button related GeoIP.

Note: Keep in mind that when you uninstall GeoIP, you will lose your configuration settings.

Minimum Requirements

Regular Labs extensions will only work correctly if your setup meets these requirements:

  • Up-to-date version of Joomla:
    • Joomla 3.9.0 or higher
    • Joomla 4.0.0 or higher
    • Joomla 5.0.0 or higher
  • Joomla 3 version: PHP 7.4 or higher
  • Joomla 4 & 5 version: PHP 8.1 or higher
  • MySQL 5 or higher

FAQ

If you have questions regarding how to Install, Update, and Uninstall Regular Labs Extensions, check out our Frequently Asked Questions section.