Welcome

This Documentation describes the installation and configuration steps of script.

While the installation process is rather simple, some of the instructions presented here will require minimum understanding in working with databases and managing files on a server.

If you're not familiar with the procedures presented, We can help you via support desk. Support Desk


License

Regular License

Use, by you or one client, in a single end product which end users are not charged for. The total price includes the item price and a buyer fee.

Extended License

Use, by you or one client, in a single end product which end users can be charged for. The total price includes the item price and a buyer fee.

Please purchase an Extended License if you are going to sell as a service. Envato License Policy


Server Requirements

We are using laravel so minimum server requirements of script should be same as the requirements of laravel framework.

  • PHP >= 8.3
  • BCMath PHP Extension
  • Ctype PHP Extension
  • Fileinfo PHP Extension
  • GD PHP Extension
  • Intl PHP Extension
  • JSON PHP Extension
  • Mbstring PHP Extension
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension
  • MySQL >= 5.7 / MariaDB >= 10.3
  • Apache mod_rewrite

Creating a New Database

Before installing, you will need to create a new empty database. If you already know how to do this or have already created one, skip to the next step. Please use an empty database. In most cases you should be able to create a database from your cPanel.

Useful resources

Via cPanel:

  1. Log in to your cPanel account.
  2. Go to MySQL Database Wizard under the Databases section.
cPanel MySQL Databases

cPanel → Databases → MySQL Databases

  1. Create a new database (e.g., craft).
Create New Database

Enter database name and click Create Database

  1. Create a new database user with a strong password.
Add New MySQL User

Create a new database user

  1. Add the user to the database.
Add User To Database

Add user to the database

  1. Grant ALL PRIVILEGES to the user.
Manage User Privileges

Select All Privileges and click Make Changes

Via Command Line:

mysql -u root -p
CREATE DATABASE craft CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'craft_user'@'localhost' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON craft.* TO 'craft_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Uploading Files

Important: Make sure that you have the .env file in your folder and the .htaccess file got copied properly from the download to your server.

Upload the contents of the main_file folder to your web root (usually public_html, html, or your domain folder).

Required folder permissions:

chmod -R 775 storage/
chmod -R 775 bootstrap/cache/
chmod -R 775 public/storage/
chmod 644 .env
Note: On some operating systems, dotfiles like .env and .htaccess are hidden by default. Make sure your file explorer has the option to view hidden files turned on before uploading.

Installation Wizard

Go to your website address, then you'll see an installation wizard. To open the installer, visit:

https://yourdomain.com/install

Now the installer will show up. The first screen will be the Welcome Screen.

Installation Welcome Screen

Welcome Screen — Click Check Requirements

Note: If you are not able to access yourdomain.com/install, but you are able to access it via yourdomain.com/index.php/install, this means that you probably don't have Apache mod_rewrite installed and enabled.

System Requirements

After clicking on "Check Requirements" button, you will be redirected to the System Requirements step during the installation wizard.

System Requirements Check

System Requirements — Verify PHP extensions


Directory Permissions

After successfully enabling and installing all required PHP extensions, the next step is to set the appropriate permissions for some system folders as shown below.

Directory Permissions

Directory Permissions — Set write permissions

For giving permissions, open your terminal window and type:

sudo chmod 777 directory_name

For example:

sudo chmod 777 storage
sudo chmod 777 bootstrap/cache

Environment Settings

Please select how you want to configure the apps .env file. You have two options:

Form Wizard Setup

Step-by-step guided form to configure your environment.

Classic Text Editor

Directly edit the .env file in a text editor.

Environment Settings Options

Choose between Form Wizard Setup or Classic Text Editor

Option A — Form Wizard Setup

If you choose Form Wizard Setup, you will be guided through three tabs:

1. Environment — Configure app name, environment, debug mode, log level, and app URL.

Form Wizard Environment Tab

Form Wizard — Environment tab

2. Database — Enter your database connection details (host, port, name, username, password).

Form Wizard Database Tab

Form Wizard — Database tab

3. Application — Configure broadcasting, caching, session, queue, and mail drivers.

Form Wizard Application Tab

Form Wizard — Application tab

Option B — Classic Text Editor

If you choose Classic Text Editor, you can directly edit the .env file contents in a text area and save.

Classic Text Editor Selected

Classic Text Editor option

Classic Environment Editor

Edit .env file directly and click Save .env


Installation Finished

The last step is the exit step. After successful installation, you will see the completion screen.

Installation Finished

Application has been successfully installed

Post-Install Security: After successful installation, reset the .env file permission to 644 for security:
chmod 644 .env

Default Login

After installation, use the following credentials to log in:

Admin Login Details

Email: admin@example.com

Password: admin@1232

Security Tip: Change the default password immediately after your first login for security reasons.

Upgrade

Before making an update, always remember to do a complete backup of your website.
  1. Make a backup of the .env config file and .htaccess located on your server.
  2. Upload and replace all the files on your server with what's inside the main_file folder.
  3. Restore your .env config file and .htaccess on your server.
  4. Run php artisan migrate to apply any new database changes.
  5. Run php artisan optimize:clear to clear cached files.

FAQ

You can contact us via our Support Desk. We typically respond within 24-48 hours on business days.

Please ensure that you have mod_rewrite enabled on your server. Also verify that the .htaccess file exists in the public directory.

This generally happens when one of the server requirements is not met. Enable debug mode by setting APP_DEBUG=true in your .env file to see the actual error message.

Go to the admin panel settings page to upload your logo (light & dark versions) and favicon. Changes apply immediately.

Yes. Add the following to your .htaccess file to force HTTPS:

RewriteCond %{HTTPS} !=on
RewriteRule ^/?(.*) https://%{HTTP_HOST}%{REQUEST_URI} [R,L]

Craft Laravel Admin Panel supports English, Arabic, and French out of the box. Translation files are located in resources/lang/ and lang/. Copy the en folder and translate the files for your new language.