Installation

Requirements#

	Minimum	Recommended
PHP	8.3	8.4
MySQL / MariaDB	8.0 / 10.6	8.0+ / 10.11+
Node.js	18.x	20.x LTS
Composer	2.5	2.7+

Required PHP extensions: BCMath, Ctype, cURL, DOM, Fileinfo, JSON, Mbstring, OpenSSL, PDO, PDO MySQL, Tokenizer, XML, GD or Imagick.

---

Quick Start (Recommended)#

1. Clone & install dependencies#

git clone https://github.com/laradashboard/laradashboard.git my-project
cd my-project
composer install
npm install # optional for production, but recommended for development to enable hot reloading

2. Start the dev server#

php artisan serve
npm run dev # optional for production, but recommended for development to enable hot reloading

3. Run the installation wizard#

Open http://localhost:8000/install in your browser and follow the steps — the wizard handles environment config, database setup, migrations, and admin account creation automatically.

---

Manual Setup (Alternative)#

If you prefer not to use the wizard:

# Copy and configure environment
cp .env.example .env
php artisan key:generate

Edit .env with your database credentials:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laradashboard
DB_USERNAME=root
DB_PASSWORD=

Then run migrations and seed:

php artisan migrate --seed

Default admin: superadmin@example.com / 12345678 — change this immediately after first login.

Build production assets when ready:

npm run build

---

Directory Permissions#

chmod -R 775 storage bootstrap/cache public/uploads

# Production — set correct ownership
chown -R www-data:www-data storage bootstrap/cache public/uploads

---

Troubleshooting#

Issue	Fix
Composer out of memory	COMPOSER_MEMORY_LIMIT=-1 composer install
Permission denied	sudo chmod -R 775 storage bootstrap/cache
PDO extension missing	sudo apt-get install php8.3-mysql (Ubuntu) or brew install php@8.3 (macOS)
Node not found	nvm install 20 && nvm use 20

---

Next Steps#

• Configuration — fine-tune app settings
• Quick Start — learn the basics
• Deployment Guide — Nginx, SSL, queues, and more