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

Configuring Database & Finishing Installation Using kickstart.php

3 min read
15.12.2025

Access the Restoration Tool

Once the backup files are extracted:

Akeeba Kickstart Database Configuration
kickstart.php — Akeeba's installer; runs without the host CMS.

For other CMS-installer / Softaculous flows, see "Installation already exists" — Softaculous Reinstall Fix and What is bitrixsetup.php?.

  1. The Akeeba Kickstart tool will prompt you with a "Run the Installer" button.
  2. Click it to proceed to:
    http://yourdomain.com/installation/index.php
  3. You will see the Akeeba Restoration Wizard (for Joomla) or the WordPress Database Setup (for WordPress).

Enter Database Details

You'll need to enter the database credentials from your hosting provider.

MySQL/MariaDB Database Information

Field Description Example
Database Type The database system MySQLi
Hostname Database server address localhost (or 127.0.0.1)
Database Name The database name mydatabase
Database Username User for the database dbuser
Database Password Password for the database user yourpassword
Table Prefix Prefix for tables (keep the default) jos_ (for Joomla)

If using cPanel, you can find database details under MySQL Databases.

Linux Hosting
Reliable and fast web hosting!
  • Free domain
  • Modern servers
  • NVMe disks
  • 7-day free trial
Linux Hosting

Test the Database Connection

Once you've entered the database details:

  1. Click "Test Connection".
  2. If successful, proceed with "Next".
  3. If an error occurs:
    • Double-check the database hostname, username, and password.
    • Make sure the database exists and is accessible.
    • Check that your hosting provider allows remote MySQL connections (for external databases).

Restore the Database

  1. Click "Restore Database".
  2. The installer will import your tables and data into the database.
  3. Wait until the process completes.

Now your website's database is restored.

Finalize the Installation

  1. Click "Next" to proceed to site configuration.
  2. If needed, update:
    • Site URL (https://yourdomain.com)
    • Admin username & password
    • Email settings (for contact forms, notifications)
  3. Click "Finish Installation".

Delete Installation Folder

For security reasons, remove the installation folder after restoring the database.

For Joomla

Click "Remove Installation Folder" or manually delete it:

rm -rf /var/www/html/installation

For WordPress

No need to remove anything manually; WordPress setup completes automatically.

Summary

Step Action
Run the Installer Open http://yourdomain.com/installation/index.php
Enter Database Details Use MySQL credentials from cPanel or VPS
Test Connection Ensure the database is accessible
Restore Database Click "Restore Database"
Finalize Installation Set site URL, admin login, email settings
Delete Installation Folder Remove /installation for security

Now your website is fully restored and live!

Frequently asked questions
Usually yes. Akeeba's ANGIE extractor needs `memory_limit` 256M+ for medium archives; bigger archives need 512M-1G. Set in php.ini (server-wide) or in .user.ini next to kickstart.php. Also check `max_execution_time = 0` for CLI or 600+ for web. If web is timing out, run via CLI: `php kickstart.php` (some versions support headless mode).
Web SAPI uses different MySQL hostname sometimes. CLI typically connects to `localhost` (Unix socket); web to `127.0.0.1` (TCP). Try both in the kickstart form. Also check the panel for the actual MySQL host — managed hosting sometimes uses `mysql.shared.example.com` not localhost.
Common: PHP version mismatch (archive from PHP 7.4 host, restoring on PHP 8.2 — deprecation warnings break pages); database collation mismatch (old utf8 → new utf8mb4 — config files reference wrong); or .htaccess rewrites pointing to old paths. Check error_log first, then configuration.php (Joomla) / wp-config.php (WordPress) for hard-coded paths.
kickstart can rewrite the DB prefix on restore — useful for putting the site into a shared DB without prefix collision. But CMS configuration (`#__` prefix in Joomla, `$table_prefix` in WordPress) and any plugin code that hard-codes the prefix must be updated. Akeeba handles core config; third-party plugin code with hardcoded prefix is up to you.
Related articles
MySQL error in file: /engine/classes/mysql.php at line 61
MX Hosting — What It Is and How to Use It? Complete Guide
kickstart.php — What It Is and How to Use It?