Tutorial for IP Login

There is a Free and a Pro version of IP Login.
The parts in this tutorial that only concern the Pro version will be marked with: PRO


IP Login is a Joomla! system plugin that allows you to log into your Joomla site automatically by IP address.

It can work for both the frontend and administrator areas of the site, based on your preference.

How to use it

You can simply set up your IP address and a secret URL key in your user profile in the administrator.

After installing IP Login, you will have the following settings in every user profile. So to set up IP Login for your user, go to the User Manager and click on your user account.

Enter your desired IP address, and any secret key you would like to use. For example:

IP Login user settings

With the above example, you will be able to automatically log in on IP address 123.456.789.123 with URL key mxx8hrv4.

The URL key needs to be put in the URL as a 'query' variable, like:

If the URL already contains a ?, you can prepend the key with an &, like:

Multiple Setup PRO

With the Pro version of IP Login, you can set up the automatic login for up to 5 combinations of IP addresses/ranges per user, all with their own unique settings and URL keys.

IP Lists PRO

The pro version of IP Login gives you the ability to use multiple IP addresses per key.

You can enter a list of IP addresses by simply separating them with a comma.

So if you want to use the key for IP addresses and you simply enter:,

IP Ranges PRO

The pro version of IP Login also gives you the ability to use IP ranges.

You can set ranges using the * wildcard to match any IP that starts with the given characters.

Or you can use a "dash" (-) for from - to ranges. In this case, the matched IP range depends on how many IP parts you give for the ending IP.

Here are some examples to show you how these work:

IPv4 Ranges

IP RangeIP addresses matching range
110.120.130.* to
110.120.* to to to to

IPv6 Ranges

IP RangeIP addresses matching range
1111:2222:3333:4444:5555:6666:7777:* 1111:2222:3333:4444:5555:6666:7777:0000 to 1111:2222:3333:4444:5555:6666:7777:ffff
1111:2222:3333:4444:5555:6666:7777:1000-1111:2222:3333:4444:5555:6666:7777:a0000 1111:2222:3333:4444:5555:6666:7777:1000 to 1111:2222:3333:4444:5555:6666:7777:a000
1111:2222:3333:4444:5555:6666:7777:8888-dddd.eeee.ffff 1111:2222:3333:4444:5555:6666:7777:8888 to 1111:2222:3333:4444:5555:dddd.eeee.ffff

Security warning

Be aware that there is a small security risk.

Though the risk is low, as a hacker would have to find out your IP address (and spoof it), know that you have set it up as an auto-login IP address, and somehow find out your secret URL key.

So security breaches are unlikely.


IP Login comes with options, giving you control over how the plugin behaves. Here is the full list of options you can find in the User Manager and in the Plugin system settings:

User: IP Login

Enable In Select whether to enable in the frontend or administrator side or both.
Options: None, Both, Admin, Frontend
IP Address Enter the IP address you want to auto login on.
IP Address / Range Enter the IP address or range you want to auto login on.
Secret URL Key The secret URL key you need to place in the URL, like: http://www.yourdomain.com/administrator?123abc
Note Enter an optional note.

The Pro version of IP Login will give you the ability to set up to 5 IP addresses/ranges per user. PRO

Plugin: Behaviour

Remove URL Key Select to remove the secret URL key from the URL on pageload.
Options: No, Yes, Admin, Frontend


You can either install IP Login by using the core extension manager available in the Joomla! Administrator Control Panel, or by using the powerful Regular Labs Extension Manager.

Note: When updating IP Login, you do not need to uninstall it first. The package will update all the files automatically.

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

Regular Labs Extension Manager

It is very easy to install/update any Regular Labs Extension using the Regular Labs Extension Manager.

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

Joomla! Extension Manager

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

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

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

  1. Download the extension install file (.zip);
  2. Log into your Joomla administrator;
  3. In the menu, choose: Extensions >> Extensions;
  4. Choose the tab: Upload Package File;
  5. Click on the Choose File button and select the extension zip;
  6. Click on Upload & Install.
Joomla! Installer - Upload Package File

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