First Time Installation - in Joomla! 3.2 or higher

Different versions of jDownloads exists for the different versions of Joomla!

These are summarised in the table below

Joomla Version:



3.0 & 3.1

3.2 & higher

jDownloads version:


Deprecated or

2.5 (recommended) Beta


Minimum Sytem Requirements

  • PHP 5.3.1+ (5.4+ recommended)
  • MySQL 5.1+
  • Joomla 3.2+ or newer

Note that if you are upgrading from a 1.9.x series to either the 2.5 or 3.2 jDownloads series then a procedure exists to transfer your existing data into the new version. Please read the note before carrying out any uninstallation of your existing version and installing the new version. The links below will take you to the relevant upgrade note.

J2.5 series upgrade     j3.2 series upgrade

 Installing jDownloads is very straight forward and follows normal Joomla procedures.

The file size of the installation package is currently 2.1MB, so make sure that your server settings for (upload_max_filesize ) is also greater than 2.1MB, say 2.5MB.

The first step is to download the latest version by going to and then selecting Downloads. You can step though to find the latest jDowloads component for Joomla 3.2 or higher and download to your PC into a suitable location.

In Joomla administration navigate to the Joomla Extensions Manager- Install, which will look something like below.


Rather than search through the web, it is simpler to select the ‘Upload Package File’ tab.Instal02









Use the browse button to select Instal03the package downloaded earlier and click on Upload & Install. This will take a couple of minutes or so.

I usually grab a cup of coffee as sitting looking at the ‘rotating’ arrow is rather boring!

If you get a completion message then so far so good and you can omit the next set of bullet points.

  • Because of the installation time limits or the package size limits on your server you may get an error. If that is the case then try the alternative installation method ‘Install from Directory’ described below. The directory here is a directory on your web server. Usually this is the /tmp directory in your website root.
  • Unzip the package file downloaded to your PC into a convenient directory on your PC. I usually use the 7zip program. Typically this directory will have in it a sub-directory called ‘com_jDownloads’.Upload com_jDownloads and its contents to the /tmp directory in the website root.
  • Unzip the package file downloaded to your PC into a convenient directory on your PC. I usually use the 7zip program. Typically this directory will have in it a sub-directory called ‘com_jDownloads’.
  • Upload com_jDownloads and its contents to the /tmp directory in the website root. This could be by using the server Control Panel or by using an FTP Client such as FileZilla. It is best to first ensure that /tmp is empty.
  • Now go to the ‘Install from Directory’ tab and enter the address of the directory on the server to which the FTP program uploaded com_jDownloads. By default Joomla will have set this to the /tmp directory.
  • Click on the Install button.
  • If you still have a fault then seek advice in the forum, being sure to give details of the error message.

When the installation process is completed, you will get an installation results message such as below.Instal04

Click on the blue ‘Start jDownloads Now’ at the foot of the message. This will now give you a screen such as that below, which is requesting you to set the Joomla ACL permissions for your downloads.  An initial simple set up of the permissions is shown below.  This is sufficient to get you started.  For more in-depth information and examples of setting Permissions and View Access levels see the article  Controlled Access to Categories and Downloads (Permissions & Access Levels).Instal05

To set these access permissions click on the ‘Options’ button at the top right.  At this juncture you have two basic schemes as a starting point:

  • Any user may download
  • Only Registered users may download

After clicking on the Options button the Component Permissions are shown  This will start by showing the Public Access permissions relating to jDownloads, which by default are set to 'inherited'.  For publically accessible Downloads set the ‘Download’ Permissions to Allowed. It is also generally helpful to also set ‘Edit Own’ to Allowed as shown below.  If you only want to have Logged on users being able to Download then first click on Registered in the left hand column.  Then set Allowed for Download, and if appropriate also for Edit Own.


After clicking on Save the you will see as shown below for the case when all downloads are to be publically available that they have indeed been ‘allowed’.  Obviously select the Registered user group to check the permission if you only want logged on users to be able to Ddownload. As above for more detailed information see the Controlled Access to Categories and Downloads (Permissions & Access Levels).  Note that in general after installation and when you get things basically set up it is advisable to set all the Component Permissions back to Inherited and then set the permissions of either the Pubic or Registered user groups for every top level  Category.  This is more work but it creates the flexibility that many Download regimes need.  Also if you think you need to set a permission to deny then it is almost certain you have set the permissions up incorrectly!  This setting of permissions on the top level categories cannot usually be done during installation as they may not exist yet!


After Close or Save & Close, you will get the standard jDownloads Control Page loaded as shown below.       Installation is now complete - so now adjust the configuration parameters.


After installing continue with the initial configuration

  • Adjust the configuration parameters to your needs.
  • Check the folder for the uploaded files. Default: YOUR_JOOMLA_ROOT/jdownloads.
  • Create your download categories structure before you create the first download and upload a file.
  • jDownloads needs at least one menu item to work properly. Create a menu item for jDownloads in the menu manager and pointing it to the jDownloads component. Use as Type: 'All Categories'.

Colin Mercer - April 2014

  • Montag, 21 April 2014