Era Host hosting
EraHost – Free Domain, Cheap Hosting!
Client Area
Support 24/7
Menu

kickstart.php — What It Is and How to Use It?

2 min read
08.03.2026

What Is kickstart.php Used For?

  • Extracting large .jpa, .zip, or .tar website backups.
  • Restoring websites on new hosting or a local development server.
  • Migrating a Joomla or WordPress website.
  • Handling large backups without FTP timeouts.
Linux Hosting
Reliable and fast web hosting!
  • Free domain
  • Modern servers
  • NVMe disks
  • 7-day free trial
Linux Hosting

How to Use kickstart.php to Restore a Website

Download & Upload kickstart.php

  1. Download kickstart.php from Akeeba's official website.
  2. Upload kickstart.php and your backup file (.jpa, .zip, or .tar) to the public_html folder of your hosting.

Run kickstart.php in a Browser

  1. Open your browser and go to:
    http://yourdomain.com/kickstart.php
  2. The Akeeba Kickstart interface will appear.

Extract the Backup

  1. Select the backup file from the list.
  2. Choose the extraction method (Directly, Use FTP if needed).
  3. Click Start to extract the files.

This step restores all website files.

Akeeba kickstart.php Restore
kickstart.php — restore Akeeba backup without existing CMS.

For the detailed step-by-step guide and related installer topics, see Configuring Database & Finishing Installation Using kickstart.php, "Installation already exists" — Softaculous Fix, and What is bitrixsetup.php?.

Configure Database & Finish Installation

Once the files are extracted, kickstart.php redirects you to the website installer (if available).

  1. Enter Database Details (if required):
    • Database Name
    • Username & Password
    • Host (localhost for most shared hosting)
  2. Click Next > Complete the setup.

Delete kickstart.php and Cleanup

After restoration, delete kickstart.php for security:

rm -f kickstart.php

Your website is now restored and live!

Troubleshooting kickstart.php Issues

Issue Fix
kickstart.php not found error Ensure the file is uploaded to public_html
Backup extraction fails Use FTP mode instead of direct extraction
PHP memory errors Increase memory_limit in php.ini (memory_limit=512M)
Database connection errors Check credentials and ensure MySQL is running

Summary

Step Action
Download & Upload Get kickstart.php and backup file, upload to hosting
Run kickstart.php Open http://yourdomain.com/kickstart.php
Extract Backup Select .jpa, .zip, or .tar and start extraction
Database Setup Enter MySQL details if required
Cleanup Delete kickstart.php for security

Now your website is successfully restored!

Frequently asked questions
(1) Backup archive (.jpa or .jps) uploaded to server. (2) kickstart.php in the same directory as the archive. (3) PHP enabled on that path. Hit `https://site/kickstart.php` in browser, it finds the .jpa, extracts. After: configure DB connection in the ANGIE installer that follows. Done — full site restored.
kickstart.php exposes a web-accessible installer to anyone. Left in place, attacker can re-trigger restoration with their own archive — total site takeover. After successful restore: delete kickstart.php, the .jpa, and the temporary ANGIE files. Akeeba's post-install screen reminds you, but easy to skip.
That's exactly what kickstart.php is for. It extracts and configures from scratch — no prior install needed. Just empty directory + kickstart.php + .jpa. Useful for site migration, fresh staging environment, disaster recovery onto new hosting.
PHP memory_limit too low for the archive size. Akeeba ANGIE needs ~128M+ for medium archives, 256M+ for bigger. max_execution_time too short — set to 0 (unlimited) or 600. If kickstart's progress freezes at 50%, those two are the typical fix. Check error log for the specific limit hit.
Related articles
Adding _globalsign-domain-verification TXT Record in DNS Settings — A Detailed Guide
Configuring Database & Finishing Installation Using kickstart.php
mbstring.func_overload Bitrix — Complete Configuration Guide