Support

Admin Tools

#42858 Not Admin Tools, Backup Restoration

Posted in ‘Admin Tools for Joomla!’
This is a public ticket

Everybody will be able to see its contents. Do not include usernames, passwords or any other sensitive information.

Environment Information

Joomla! version
5.4.4
PHP version
8.3
Admin Tools version
n/a

Latest post by headcake on Tuesday, 14 April 2026 11:23 CDT

headcake

I have a site I built for a client on my GoDaddy server and I'm trying to move it to Network Solutions. When I tried kickstart.php on Network Solutions it said there was security and I need to upload a kickstart.json.php file, which I did. Then when unpacking the site I continually got "Suboptimal PHP OPcache settings detected" and to have the NS host add "opcache.revalidate_path=1" to the PHP. I did that as well, but getting them to do that was not easy. After they added it, and I tried to install the site, I continually get the error "An unexpected error occurred". I tried the suggested changes to adjust the minimum and maximum execution times with no success.

I thought I'd just unpack the website on my GoDaddy server where I have about 15 Joomla websites with Akeeba backup. I've restored several websites on this server with easy success. This time, I get the exact same issues with GoDaddy as I am getting with Network Solutions! The OPchache settings, the kickstart security issue, and the continual "unexpected error". 

I don't understand what is happening and how to fix it. I'm terrified that if I need to restore a website on the same server the site is on that I no longer can trust Akeeba Backup to do so. I'm hoping it's a simple fix that I am missing, but I could not find any solutions on the Akeeba website or on other forums.

 

Please help.

nicholas
Akeeba Staff
Manager

When I tried kickstart.php on Network Solutions it said there was security and I need to upload a kickstart.json.php file, which I did.

It actually said that using the default name is insecure. You can either rename the file or upload a kickstart.json.php file to set a password. See https://www.akeeba.com/documentation/akeeba-kickstart-documentation/security.html 

Then when unpacking the site I continually got "Suboptimal PHP OPcache settings detected" and to have the NS host add "opcache.revalidate_path=1" to the PHP.

It actually says that Kickstart may not work unless these settings are changed. It is not a necessity. It depends on other server configuration factors.

The idea here is that many people had a failure because of these settings. Instead of having to answer the same ticket two times a week, every week, I just preemptively notify you that if Kickstart fails to run once you see this page, change these settings.

After they added it, and I tried to install the site, I continually get the error "An unexpected error occurred".

Do you still see the notification at the top of the page? It only displays if any of the four OPcache settings that matter are not already set to their recommended values. The message only displays the settings which are not set to their recommended values. Which is to say, if you still see it, the problem is those settings – and that's why I am asking this question.

Essentially, the vast majority of "unexpected error" is the server failing to run the PHAR archive correctly. The reason, if you've reached that point, is the OPcache settings.

If all else fails you can try bypassing PHAR as per the documentation.

Nicholas K. Dionysopoulos

Lead Developer and Director

🇬🇷Greek: native 🇬🇧English: excellent 🇫🇷French: basic • 🕐 My time zone is Europe / Athens
Please keep in mind my timezone and cultural differences when reading my replies. Thank you!

headcake

I apologize for not explaining things well. I'm just frustrated. I did more research on my own and was not able to get past a certain point.

I was able to get the site unpacked, but when I tried to install the site, I get stuck in the restoration script. If I try again, it gives me a "Restoration is complete" notice, but it never asked for the new database info therefore my site is just a red page. I've unpacked it a few times and get the same result. I have unpacked the site on my GoDaddy server successfully and tried copying over all the files to the Network Solutions server, then tried the .../installation/index.php. This is the part I cannot seem to get past. It either stays in the restoration script or restoration complete without the new database info.

Clearly I'm doing something wrong. I'm not new to this but it has been about a year since I have had to restore or move a website. It's always been so easy and instant. I'm sure things have changed. No insult intended to Akeeba. Why am I having so much trouble with this move?

nicholas
Akeeba Staff
Manager

I am afraid this post made things even less clear than before :(

Let's start with some simple facts.

Kickstart is the file which allows you to extract the backup archive contents. That is all it does.

The actual restoration is done by the Akeeba Backup Restoration Script (BRS). The BRS is included in the backup archive. It is extracted in the installation directory.

The "An unexpected error occurred" message appears ONLY in Kickstart. There is no such thing in BRS. That's why I was asking about more information about Kickstart in my previous reply. However, you replied that Kickstart has run and extracted your backup archive. I do not believe it has, at least not in full.

Here's what I want you to do.

Take screenshots –NOT a video– in PNG format for each step of what you are doing. If there's an error message make sure to include one or more separate screenshots where the entirety of the message is captured clearly and legibly. Do not resize the screenshots.

Put all the screenshots in a ZIP file.

Upload the ZIP file with your next reply.

This will let me understand what is going on.

Important: The reason I am asking for screenshots instead of a video is that in my experience people trying to take a screen recording (video) just wave their cursor about as they are talking, the video is compressed so much that I cannot read their screen due to compression artefacts and resolution, and by the time they are on a page I actually want to read the contents of they have already clicked away before the compression algorithm had enough time to give me a somewhat clearer picture of what the heck is displayed on the page. There's no such problem with screenshots. They are clear and full resolution.

Nicholas K. Dionysopoulos

Lead Developer and Director

🇬🇷Greek: native 🇬🇧English: excellent 🇫🇷French: basic • 🕐 My time zone is Europe / Athens
Please keep in mind my timezone and cultural differences when reading my replies. Thank you!

headcake

Thank you for your help on this. I'm not very good at explaining myself.


I was able to get around the installation issues by unpacking the site on my GoDaddy server and transferring the files and folders via FTP to the Network Solutions server. Then I have been using my browser and going directly to ...Rathsburg/installation/ to start the installation. I've included a screen shot of what I get when I do this on the GoDaddy server (Screenshot GoDaddy Installation folder.png) which looks great, but when I go to it on the NS server, I see the spinning dial of death "Initializing The restoration script is getting ready" (Screenshot NS Installation folder.png). I've included a screen shot of my folder structure via FTP so you can see what was unpacked (Screenshot unpacked structure.png). If I click on "check again" or "start over" buttons at the top right it doesn't change the results. 


I've deleted all the files/folders on the NS server and re-copied them from the GoDaddy server a few times to make sure I didn't miss any, but no success.


I also just tried to unpack the site again by uploading a new .jpa backup file along with the kickstart.php and kickstart.json.php in a new folder .../Rathsburg2/ and it did successfully unpack the site. But when it got to the installation, that’s when it gives me the endless “Initializing.”


 It seems the only hangup is the installation?

nicholas
Akeeba Staff
Manager

I am pretty sure your problem has to do with JavaScript not executing on the site. There are two common reasons for that.

One is that you have a .htaccess file in a parent directory. These files cascade across the filesystem, not the logical "site" they belong to. Try renaming any such files to htaccess.bak.

The other common issue is that you are trying to access your site over HTTPS but it's not set up correctly with a valid, commercially signed certificate, or that your server is not reporting the site as being accessed over HTTPS. This will cause mixed content warnings in the browser's developer console, the browser will refuse to load and execute the JavaScript code, and you're stuck. Try accessing your site over plain HTTP instead.

Nicholas K. Dionysopoulos

Lead Developer and Director

🇬🇷Greek: native 🇬🇧English: excellent 🇫🇷French: basic • 🕐 My time zone is Europe / Athens
Please keep in mind my timezone and cultural differences when reading my replies. Thank you!

headcake

To speed up the trial & error, I’m doing these tests on the build I have in two folders; Rathsburg and Rathsburg2.
I renamed the .htaccess to htaccess.bak in the parent directory.
I changed the url from https: to http: but it continually defaults to https: every time after I hit enter.
When I tried to run the installer Rathsburg2/installation/index.php it simply says the restoration is complete. It never asks me for a database to use, and therefore the site is just not there.
I re-uploaded new files for the install on Rathsburg/installation/index.php to start from scratch and still run into the same Initializing spinning wheel of death. If I hit Restart or Try Again, I still get the spinning wheel. If I go to the url and remove the s from https: then I get the Restoration Complete message when it never asks me for the database info.

nicholas
Akeeba Staff
Manager

Delete the files inside the installation/tmp folder. What happens when you go back to installation/index.php?

Nicholas K. Dionysopoulos

Lead Developer and Director

🇬🇷Greek: native 🇬🇧English: excellent 🇫🇷French: basic • 🕐 My time zone is Europe / Athens
Please keep in mind my timezone and cultural differences when reading my replies. Thank you!

headcake

That did it. I was able to finish the connection to the database and finish restoring the site. Thank you!

So for the future, if I need to restore a backup on this server again, is there a way to avoid this issue?

nicholas
Akeeba Staff
Manager

Sorry it took so long. Your question was quite simple, but it took me a while to understand what you were actually asking me to help you with because there was a lot of conflicting information in the first couple of posts. I believe it all comes from the fact that you conflate Kickstart with the the Akeeba Backup Restoration Script (BRS). The former is the .php file you run first to extract the backup archive. The latter is extracted into the installation directory and its job is to restore the database content and reconfigure your site. Since you were asking me about Kickstart and giving me an error message that matched Kickstart but not BRS I was very confused as to what you were trying to do.

Your problem was that you had already gone through the restoration script (the script extracted in the installation folder) once, unsuccessfully. Then, without having removed the installation script, you retried the restoration but were taken to the very last page of the restoration script. You needed a way to reset BRS so it goes all the way from the start.

When that happens, yes, you need to delete the files inside the installation/tmp directory.

Every time you use BRS it needs to "remember" things between successive pages. It does that by creating a PHP session and save it into a file under installation/tmp. The name of that file depends on your site, so I can't tell you in advance what it will be.

Part of it is the current restoration step you are in. This is intentional. If you accidentally close the tab and then reopen it (or open a new tab/window and visit the installation/index.php URL) it will take you directly to the step you were in, without forcing you to go through the entire restoration process up to this point. Convenient, but can get you stumped as it happened to you.

One way to go all the way back is to use the Previous button in the toolbar until you are back to the very first page, then click on Start Over in BRS' toolbar to reset the session which –guess what?– deleted the session file from the installation/tmp directory. The other way is to do away with the middleman and remove the installation/tmp contents yourself.

Now you know the what and the why. If you have any follow-up or clarification questions feel free to ask me. I'm here to help!

Nicholas K. Dionysopoulos

Lead Developer and Director

🇬🇷Greek: native 🇬🇧English: excellent 🇫🇷French: basic • 🕐 My time zone is Europe / Athens
Please keep in mind my timezone and cultural differences when reading my replies. Thank you!

headcake

My apologies for not being clear to begin with, I was getting frustrated and confused. After going through it as we did, and your explanation, it makes way more sense. If it happens again, I'll have this to refer back to, but I'll just jump to the end.

Support Information

Working hours: We are open Monday to Friday, 9am to 7pm Cyprus timezone (EET / EEST). Support is provided by the same developers writing the software, all of which live in Europe. You can still file tickets outside of our working hours, but we cannot respond to them until we're back at the office.

Support policy: We would like to kindly inform you that when using our support you have already agreed to the Support Policy which is part of our Terms of Service. Thank you for your understanding and for helping us help you!