Skip to content

IronWillDevops/ITkha

Repository files navigation

Laravel Website with Admin Panel

A Laravel-based website featuring an admin panel, queue processing, and CAPTCHA support via php-gd.

⚙️ Requirements

  • PHP >= 8.1
  • Composer
  • MySQL
  • Redis (optional, for queue)
  • PHP extension: php-gd
  • Web server (e.g., Nginx or Apache)
  • Supervisor or process manager (for queue workers)

🚀 Installation

  1. Clone the repository:
git clone https://github.com/IronWillDevops/ITkha.git
cd your-repo
  1. Install PHP dependencies:
composer install
  1. Copy the .env.example file to .env and fill in the required configuration:
cp .env.example .env
  1. Generate the application key:
php artisan key:generate
  1. Run database migrations and seeders:
php artisan migrate --seed
  1. Build frontend assets:
npm install
npm run build
  1. Start the queue worker:
php artisan queue:work

In production, use Supervisor or a process manager to keep the queue worker running.

📄 Required .env Configuration

APP_URL=http://example.test
APP_BASE_DOMAIN=example.test
SESSION_DOMAIN=.example.test

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=dbname
DB_USERNAME=root
DB_PASSWORD=password

MAIL_MAILER=smtp
MAIL_HOST=ip-address
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS=from@example.com
MAIL_FROM_NAME="${APP_NAME}"

⚠️ Make sure the php-gd extension is installed and enabled for CAPTCHA functionality.

🌐 Local Domain Configuration

Update your system’s hosts file:

127.0.0.1 example.test
127.0.0.1 admin.example.test

🔐 Admin Panel

URL: http://admin.example.test/dashboard

Default credentials:

  • Email: admin@example.com
  • Password: password

📌 Features

Admin panel for managing the application Email sending configured via SMTP CAPTCHA support using php-gd Task queue using Laravel’s queue system

📄 License

This project is open-source and available under the MIT license.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors