Support

Documentation

Chapter 2. Installation, updates and upgrades

Installing Akeeba Backup

Installing Akeeba Backup is no different than installing any other Joomla!™ extension on your site. You can read the complete instructions for installing Joomla!™ extensions on the official help page. Throughout this chapter we assume that you are familiar with these instructions and we will try not to duplicate them.

Installing or manually updating the extension

Just like with most Joomla! extensions there are three ways to install or manually update Akeeba Backup on your site:

  • Install from URL. This works only with the Professional release of our component. It is the easiest and fastest one, if your server supports it. Most servers do support this method.

  • Upload and install. That's the typical extension installation method for Joomla! extensions. It rarely fails.

  • Manual installation. This is the hardest, but virtually fail-safe, installation method.

Please note that installing and updating Akeeba Backup (and almost all Joomla! extensions) is actually the same thing. If you want to update Akeeba Backup please remember that you MUST NOT uninstall it before installing the new version! When you uninstall Akeeba Backup you will lose all your backup settings and all backup archives stored inside Akeeba Backup's directories (including the default backup output directory). This is definitely something you do not want to happen! Instead, simply install the new version on top of the old one. Joomla! will figure out that you are doing an update and will treat it as such, automatically.

[Tip]Tip

If you find that after installing or updating Akeeba Backup it is missing some features or doesn't work, please try installing the same version a second time, without uninstalling the component. The reason is that very few times the Joomla! extensions installer infrastructure gets confused and fails to copy some files or entire folders. By repeating the installation you force it to copy the missing files and folders, solving the problem.

Install from URL

The easiest way to install Akeeba Backup Professional is using the Install from URL feature in Joomla!.

[Important]Important

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, www.akeeba.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.

First, go to our site's download page for Akeeba Backup. Make sure you are logged in. If not, log in now. These instructions won't work if you are not logged in! Click on the All Files button of the version you want to install. Please note that the latest released version is always listed first on the page. On that page you will find both Akeeba Backup Core and Professional. Next to the Professional edition's Download Now button you will see the Direct Install Link link. Right click on it and select Copy link address or whatever your browser calls this.

Now go to your site's administator page and click on Extensions, Manage. Click on the Install from URL tab. Clear the contents of the Install URL field and paste the URL you copied from our site's download page. Then click on the Install button. Joomla! will download and install the Akeeba Backup update.

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

Upload and install.

You can download the latest installation packages our site's download page for Akeeba Backup. Please note that the latest version is always on top. If you have an older version of Joomla! or PHP please consult our Compatibility page to find the version of Akeeba Backup compatible with your Joomla! and PHP versions. In either case click on the version you want to download and install.

If you are not a subscriber, click on the Akeeba Backup Core to download the ZIP installation package of the free of charge version.

If you are a subscriber to the Professional release, please make sure that you have loged in first. You should then see an item on this page reading Akeeba Backup Professional. If you do not see it, please log out and log back in. Click on the Professional item to download the ZIP installation package.

All Akeeba Backup installation packages contain the component and all of its associated extensions. Installing it will install all of these items automatically. It can also be used to upgrade Akeeba Backup; just install it without uninstalling the previous release.

In any case, do not extract the ZIP files yet!

[Warning]Warning

Attention Mac OS X users! Safari, the default web server provided to you by Apple, is automatically extracting the ZIP file into a directory and removes the ZIP file. In order to install the extension through Joomla!'s extensions installer you must select that directory, right-click on it and select Compress to get a ZIP file of its contents. This behaviour was changed in Mac OS X Mountain Lion, but people upgrading from older versions of Mac OS X (Mac OS X Lion and earlier) will witness the old, automatic ZIP extraction, behaviour.

Log in to your site's administrator section. Click on Extensions, Manage link on the top menu. Please click on the Upload Package File tab. Drag and drop the installation ZIP file you had previously downloaded to start the upload and the installation. After a short while, Joomla!™ will tell you that the component has been installed.

[Warning]Warning

Akeeba Backup is a big extension (over 2Mb for the Professional release). Some servers do not allow you to upload files that big. If this is the case you can try the Manual installation or ask your host to follow our installation troubleshooting instructions under "You get an error about the package not being uploaded to the server".

If you have WAMPServer (or any other prepackaged local server), please note that its default configuration does not allow files over 2Mb to be uploaded. To work around that you will need to modify your php.ini and restart the server. On WAMPserver left-click on the WAMP icon (the green W), click on PHP, php.ini. Find the line beginning with upload_max_filesize. Change it so that it reads:

upload_max_filesize = 6M

Save this file. Now, left-click on the WAMP icon, click on Apache, Service, Restart Service and you can now install the component. Editing the php.ini file should also work on all other servers, local and live alike.

If the installation did not work, please take a look at our installation troubleshooting instructions or try the manual installation described below.

Manual installation

As of Akeeba Backup 5.0.0 this method can no longer be supported for technical reasons which have to do with the way Joomla! works when installing extensions of the type "package".

[Warning]Warning

DO NOT UNZIP THE PACKAGE AND TRY TO INSTALL THE EXTENSIONS MANUALLY! This will very likely make your site fail with an error. When you are installing the package extension Joomla! makes a few checks to make sure that your server meets the minimum requirements. Moreover, the installation order in the package matters. It is designed to make sure that failure to install one of the included extensions will minimize the chance of a cascading effect which breaks your site.

The installation / update broke my site!

Some users have reported that after they have installed or updated Akeeba Backup, they were no longer able to access parts of their site, especially the back-end. This is an indication of a failed or partial installation. Should this happen, use your FTP client to remove the following directories (some of them may not be present on your site; this is normal):

administrator/component/com_akeeba
component/com_akeeba
media/com_akeeba
plugins/quickicon/akeebabackup
plugins/system/akeebaupdatecheck
plugins/system/backuponupdate

This will do the trick! You will now be able to access your site's administrator page again and retry installing Akeeba Backup without uninstalling it first. Remember, uninstalling Akeeba Backup will remove your settings and your backups; you do not want that to happen!

[Note]Note

If you get a username and password dialog from your browser (not Joomla!) OR a server error when you access your site's backend (administrator) URL, try deleting the .htaccess and .htpasswd files inside your site's administrator folder.

In some cases Joomla! forgets to install files for the FOF 3 library used by most of our components (Akeeba Backup, Admin Tools, Akeeba Ticket System and others). This could mean that even removing the directories above you could still be unable to access your site. If this happens, try the following solution:

  1. Delete the folder libraries/fof30 from your site. ATTENTION! Do NOT remove the libraries/fof folder, it's something entirely different and you will break your site if you remove that folder instead!

  2. Go to our Download page and download the latest version of FOF. This downloads a file named something like lib_fof30-1.2.3.zip on your computer.

  3. Extract (unzip) the file you downloaded. You see a fof directory being extracted.

  4. Rename to fof directory to fof30

  5. Upload the fof30 directory into your site's libraries directory.

  6. You now have a libraries/fof30 directory and you can log in to your site's backend.

  7. Reinstall our extension twice in a row