Support

Documentation Akeeba Backup – User's Guide

Automatic updates

Choosing an update method

Akeeba Backup offers two update methods: Joomla! Extensions Update and Built-in.

The Joomla! Extensions Update method uses the extensions update feature that's part of Joomla! itself. Due to limitations in the early implementations of this feature in older versions of Joomla! this method is only recommended and supported for Joomla! 3.2.0 and later. If you try updating Akeeba Backup Professional with the Joomla! extensions updater under Joomla! 1.6, 1.7, 2.5, 3.0 or 3.1 you will get an error. No support will be provided in this case; instead, you will be asked to read this page for further information.

The Built-in method uses our own code to retrieve update information, download the update package and extract it on your server. Joomla!'s own extensions installer code is used only to install the update on your server. This is the only supported method for updates under Joomla! 1.6, 1.7, 2.5, 3.0 and 3.1.

You can choose the preferred update method in Components, Akeeba Backup, Options (or Preferences in some older versions of Joomla!), under the Live Update header. Please note that this option is ignored under Joomla! 1.6, 1.7, 2.5, 3.0 and 3.1. In these Joomla! versions the Built-in method will always be used.

Manually checking for the latest version and upgrading

You can easily check for the latest published version of the Akeeba Backup component by visiting http://www.akeebabackup.com/latest. The page lists the version and release date of the latest Akeeba Backup release. You can check it against the data which appear on the right-hand pane of your Akeeba Backup Control Panel. If your release is out of date, simply click on the Download link to download the install package of the latest release to your PC.

[Important]Important

If you have the (paid) Professional edition you must enter your Download ID before trying to update the extension. Otherwise you may get a cryptic error message that downloading the update has failed. If you are using the free of charge Core edition or installing the updates manually you do not need to enter a Download ID.

Updating on Joomla! 1.x, 2.5, 3.0 and 3.1 with the Built-in update feature

[Important]Important

This is the only supported method on Joomla! 1.x, 2.5, 3.0 and 3.1.

When you select the Built-in update method it is Akeeba Backup that is responsible for retrieving the update information, downloading the update files and extracting them. However, the last part of the update (installing the updated component) is performed by Joomla!'s own code due to restrictions imposed by the Joomla! Extensions Directory (we are forbidden from writing our own extensions installer).

To access the updates go to Components, Akeeba Backup. If there is an update available you will see a yellow banner at the top of the page within a few seconds. Click the Update to X.Y.Z button on the banner (where X.Y.Z is the latest version number of Akeeba Backup). You will see a page with the summary of the update information. Click on the big, green Upgrade button to start the update process. Akeeba Backup will now begin to download, extract and install the update.

Updating on Joomla! 3.2.0 and later with the Joomla! Extensions Update feature

[Important]Important

This method is ONLY supported on Joomla! 3.2.0 and later. Do NOT try to update Akeeba Backup Professional with Joomla! Extensions Update under Joomla! 1.6, 1.7, 2.5, 3.0 or 3.1: the update will fail! If you did that, please enable the Built-in method and follow the instructions ABOVE.

[Note]Note

This Joomla! feature requires that your server supports fopen() URL wrappers (allow_url_fopen is set to 1 in your server's php.ini file) or has the PHP cURL extension enabled. Moreover, if your server has a firewall, it has to allow TCP connections over ports 80 and 443 to www.akeebabackup.com and cdn.akeebabackup.com. If you don't see any updates or if they fail to download please ask your host to check that these conditions are met. If they are met but you still do not see the updates please file a bug report in the official Joomla! forum. In the meantime you can use the manual update methods discussed further below this page.

[Important]Important

If you have the (paid) Professional edition you must enter your Download ID before trying to update the extension. Otherwise Joomla! will return a cryptic error message that downloading the update has failed. If you are using the free of charge Core edition you do not need to enter a Download ID.

Akeeba Backup can be updated just like any other Joomla! extension, using the Joomla! extensions update feature as long as you are using Joomla! 3.2.0 or later. Older versions of Joomla! have limitations which do NOT allow Akeeba Backup Professional to be updated and will, instead, return an error.

When you are using the Joomla! extensions updater it is Joomla! that's responsible for finding the updates, downloading them and installing them on your server. You can access the extensions update feature in two different ways:

  • From the icon your Joomla! administrator control panel page. On Joomla! 3 you will find the icon in the left-hand sidebar, under the Maintenance header. It has an icon which looks like an empty star. When there are updates found for any of your extensions you will see the Updates are available message. Clicking on it will get you to the Update page of Joomla! Extensions Manager.

  • From the top menu of your Joomla! administrator click on Extensions, Extensions Manager. From that page click on the Update tab found in the left-hand sidebar. Clicking on it will get you to the Update page of Joomla! Extensions Manager.

If you do not see the updates try clicking on the Find Updates button in the toolbar. If you do not see the updates still you may want to wait up to 24 hours before retrying. This has to do with the way the update CDN works and how Joomla! caches the update information.

If there is an update available for Akeeba Backup tick the box to the left of its row and then click on the Update button in the toolbar. Joomla! will now download and install the update.

[Warning]Warning

Akeeba Backup Professional needs you to set up the Download ID before you can install the updates. You can find your main download ID or create additional Download IDs on our site's Add-on Download IDs page. Then go to your site's administrator page and click on Components, Akeeba Backup, Options (in the toolbar). Click on the Live Update tab and paste your Download ID there. Finally, click on Save & Close.

If Joomla! cannot download the package, please use one of the manual update methods described below. If, however you get an error about copying files, folder not found or a cryptic "-1" error please follow our installation troubleshooting instructions.

If you get a white page while installing the update please try either the Built-in method (described above) or the manual update method (described below).

Updating manually

As noted in the installation section, installing and updating Akeeba Backup is actually the same thing. If the automatic update using Joomla!'s extensions update feature does not work, please install the update manually following the instructions in the installation section of this documentation.

[Important]Important

When installing an update manually you MUST NOT uninstall your existing version of Akeeba Backup. Uninstalling Akeeba Backup will always remove all your settings and any existing backup archives stored on your server. You definitely not want that to happen!

Sometimes Joomla! may forget to copy some files when updating extensions. If you find Akeeba Backup suddenly not working or if you get a warning that your installation is corrupt you need to download the latest version's ZIP file and install it twice on your site, without uninstalling it before or in-between these installations. This will most certainly fix this issue.

Still need support?

Login or Subscribe to submit a new ticket.

(If filing a bug or you have a pre-sales request, please contact us directly.)