Installation Guide
Server Requirements
PHP Version: 8.2 or higher
Required PHP Extensions:
- PDO
- OpenSSL
- Mbstring
- Tokenizer
- XML
- Ctype
- JSON
- BCMath
- Fileinfo
- GD or Imagick (for image processing)
Database:
- MySQL 5.7+ or MariaDB 10.3+
- PostgreSQL 10+ (optional)
- SQLite 3.8+ (optional)
Web Server:
- Apache 2.4+ with mod_rewrite
- Nginx 1.18+
- Laravel development server (for testing only)
File Permissions
The following directories must be writable:
storage/(and all subdirectories)bootstrap/cache/public/(for uploaded files)
Recommended Permissions:
- Directories:
755 - Files:
644
What You'll Need
Before starting, have these details ready:
-
Database Credentials:
- Database Host (usually
localhostor127.0.0.1) - Database Name
- Database Username
- Database Password
- Database Port (default:
3306for MySQL)
- Database Host (usually
-
Application Details:
- Application Name
- Application URL (e.g.,
https://your-domain.com) - Admin Email Address
- Admin Password (strong password recommended)
-
Optional:
- Timezone (default:
UTC) - Locale (default:
en)
- Timezone (default:
🚀 Quick Start
For Test Locally (local serve)
Extract the
# 1. Extract the zip file
# 2. Install dependencies
composer install
npm install && npm run build
# 3. Set up environment file
cp .env.example .env
# 4. Start the web installer
php artisan serve
# 5. Visit http://127.0.0.1:8000/install in your browser
For Live Server
- Upload all files to your web server
- Point your domain to the
publicdirectory - Visit
https://your-domain.com/installin your browser - Follow the on-screen instructions and complete the installation process
Quick Start
Get Started in Minutes
Follow these simple steps to get OnePanel - Laravel Admin Panel Template up and running quickly.
Quick Links
Need More Help?
Our comprehensive documentation covers everything from basic setup to advanced configurations. Check out these additional resources: