The most common issue of all is, surprisingly, not having enough disk space. In order to restore a backup archive you need to have at least as much space as kickstart.php, your backup archive and all of the extracted files occupy. As a rule of thumb, you need about 2.5 times as much disk space as your backup archive. In other words, if you have a 100Mb archive file, make sure your site has at least 250Mb of free space before uploading Kickstart and the backup archive to it.
If you have a multi-part archive (files named .jpa, .j01, .j02, etc or .zip, .z01, .z02 etc) remember to upload all of the archive parts, otherwise the extraction will, of course, fail. More specifically, the extraction might continue up to the point where Kickstart determines that a part file is missing. Then, it will tell you that the archive is invalid, corrupt or archive parts are missing (older versions will just show INVALID_HEADER without further information). Moreover, make sure that all backup archives have been downloaded from a live server and/or uploaded to a live server using FTP in Binary transfer mode. Any other way to transfer them will most likely corrupt them, making restoration impossible. We suggest using FileZilla to do that. As soon as you connect to your site and right before downloading/uploading any files click on the, , menu item.
If you are restoring on a Windows server or local WAMP/XAMPP/other local server solution and you receive an error message like "Could not create test/info/N:/ folder", take a good look at the error message. If the file name contains a colon (:), slash (/), question mark (?), asterisk (*), vertical bar (|), quotation mark ("), less than (<) or greater than (>) then you can not use Kickstart to extract the archive. The reason is that these characters are valid for files stored on a Linux, Mac OS X, *BSD, Solaris or other UNIX-based operating system, but not on Windows. The only workaround is to use our free Akeeba eXtract Wizard desktop application to extract the archive, as it knows about this problem and will skip extracting those files. Then, move your file's to the new site's root and access the restoration script as, say, http://localhost/mysite/installation/index.php in order to continue the restoration.
If that doesn't work, please indicate the type of server you are restoring to
If you are on a local host, be advised that permissions or Windows ACL may be interfering with Kickstart's operation.
If you are on a Linux
machine, change the permissions of the root of your
to-be-restored website to 0777. For example, if you're trying to
/var/www/mysite you have to issue
a command like chmod -Rf 0777 /var/www/mysite
after you have put Kickstart and the archive in there, but
before launching Kickstart
If you are on a Mac OS X
machine, use the Finder to find your site's root.
Right-click or Control-click on it and select . Scroll down to the Sharing &
Permissions slider and expand it if it's not already
expanded. Find the row where the Name column
everyone and set the
If you are on a Windows XP Home machine, use Windows explorer to find your site's root. Right click on it, select and clear (unselect - it must be blank, not gray!) the Read Only checkbox. Click OK and, if prompted, tell Windows to apply this to all files and subdirectories.
If you are on a Windows XP Professional, Vista (all versions) or 7 (all versions) machine, use Windows explorer to find your site's root. Right click on it, select and click on the Security tab. Click on the button. If you can't see a user named Everyone, you will have to click on the button, type Everyone in the big text box and click . Now click on the Everyone user and then take a look at the list of checkboxes below. Click the Accept checkbox on the Full Control row (the topmost one). Click on , then again on .
If you are restoring a backup taken on Linux / Mac OS X on a Windows machnie there is another possibility. You may have a filename which is valid under Linux / Mac OS X but not on Windows such as "index.php?something". In this example the question mark is an allowed filename character on Linux but not on Windows. In such cases you can extract the backup archive using Akeeba eXtract Wizard or Akeeba Kickstart as long as you check the Ignore most errors checkbox. This will tell eXtract or Kickstart to ignore files which cannot be opened for writing. But beware! This will also skip files with legitimate filenames which are attempted to be extracted on unwritable directories. So, our suggestion is to first try adjusting the Security privileges and only if all else fails should you resort to using the Ignore most errors checkbox.
If you are on a live server which doesn't use suPHP (most hosts; if in doubt, your host is most likely one of them) you will have to use Kickstart's FTP mode.
DO NOT SET YOUR SITE ROOT'S PERMISSIONS TO 0777. This will most likely work, but it is a terribly unsafe setting. Use Kickstart's FTP mode as outlined below instead.
First, upload kickstart.php and the archive file(s) to your
server. Before starting Kickstart, you will have to do some
preparatory work. Using your FTP client application, create a
kicktemp inside the same
kickstart.php is in. For example,
kickstart.php is in
public_html directory you have to create the
kicktemp directory inside the
public_html directory. Using your FTP client
application give that directory 0777 permissions (read, write and
browse/execute to owner, group and others). Don't worry, we will
get rid of that directory later.
When Kickstart starts, set the Write to
files option to
Use FTP. In the fields
which appear below you have to supply your FTP host name (usually
it's localhost, 127.0.0.1 or the FTP hostname provided to you by
your host), the FTP username and password provided by your host
and the FTP directory.
In order to determine the proper FTP directory, do this.
Connect to your site using FileZilla. Navigate inside the folder
Joomla! is installed in. Usually it's a directory named
www or something similar. If unsure don't ask
us, ask your host. Now, on the right-hand pane you will find the
FTP path. Most likely it will look something like
/public_html. Copy this and paste it into the
FTP Directory text box in Kickstart.
In the Temporary Directory box you see
that there is already something written in it. Append (do not
/kicktemp to it. For example, if it
should now read
Click on the button next to it. It
should tell you that the directory is readable. If not, retry the
above procedure and don't skip any steps. Then click on the
button. It should tell
you that the FTP connection was established. If not, ask your host
if they do support sites writing to themselves using FTP. If they
don't you'll have to manually extract the archive locally (e.g.
using Akeeba eXtract Wizard) and upload the files manually. In
this case, please consult the Quick
Start Guide for further instructions.
Some hosts do not allow you to upload files named