Automatic Installation

Step-by-step guide to quickly set up the Laravel project using the auto-installer.

📌 What is this file for?

This file provides a step-by-step guide for automatically installing the Laravel project using the built-in installation wizard.
It is especially helpful if you are uploading the KiviCare Laravel project for the first time on your server and want a quick and error-free setup using the installer interface — without manually configuring everything.

✅ Overview of Steps:

Step 1: Launch the Installer

After successfully uploading your Laravel project to the server, open your browser and visit:

https://yourdomainname.com/install

This will open the KiviCare Laravel Setup Wizard.

Step 2: Check Server Requirements

• Click the “Check Requirements” button.
• The system will automatically check if your server meets all necessary Laravel requirements.

• If everything is correct, all items will show a ✔ mark.
• Click the “Check Permission” button to continue.

Step 3: Verify File & Folder Permissions

• Laravel will now check whether required folders and files have proper read/write permissions.
• If all permissions are granted, click the “Configure Environment” button.

Step 4: Configure the Environment

At this stage, the system will ask you to set up your application’s core configuration.

You will get two options:

1. ✅ Form Wizard Setup (Recommended for most users)
2. 🔧 Classic Text Editor (For advanced users)

🔹 Option 1: Form Wizard Setup (Recommended)

Step 4.1 – Enter Site Information

Click the “Form Wizard Setup” button and fill in the required fields:

• App Name: Your website or project name
• App Environment: Choose production, local, etc.
• App Debug Mode: Enable or disable debugging
• App URL: Enter your site URL (e.g., https://yourdomain.com) Note: Do NOT add a trailing slash / at the end of the URL.

Click “Setup Database” to continue.

Step 4.2 – Enter Database Details

Now enter the details of your MySQL database:

• Database Connection: Usually mysql
• Database Host: Normally 127.0.0.1 or localhost
• Database Port: Typically 3306
• Database Username: Your database username
• Database Password: Your database password
• Database Name: The database you created earlier

Click “Setup Application” to proceed.

– – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – – –

🔸 Option 2: Classic Text Editor (Advanced)

Step 4.3 – Application Configuration

In this step, you will configure some advanced options:

• Log settings
• Email configuration (SMTP)
• Optional: Pusher, Redis settings

After filling everything, click “Save and Install”.

Step 4.4 – Configure Using .env File

• Click the “Classic Text Editor” button

• Manually fill the .env file with required configuration (App name, DB info, etc.)

Click “Save .env” and then “Save and Install” to complete the setup.

✅ Installation Complete

If everything is filled correctly, you will see the “Installation Completed” screen.

Your Laravel system is now installed and ready to use!