Installation

Installation Guide

Welcome to the installation guide for PW-Panel (Perfect World User Panel). Follow the steps below to get your panel up and running.

Prerequisites

Before you begin, make sure you have the following installed on your server:

• PHP (version 7.4 or higher recommended)
• Composer (dependency manager for PHP)
• Web Server (Apache, Nginx, or similar)
• MySQL/MariaDB (or compatible database)
• Git (for cloning the repository, optional)
• Node.js & NPM (if using front-end tools, optional)

1. Clone the Repository

Clone the repository to your desired directory:

git clone https://github.com/hrace009/PW-Panel.git
cd PW-Panel

Or download the ZIP from our release section and extract it.

2. Install Dependencies

Install PHP dependencies using Composer:

composer install

If your project uses front-end assets, install them with:

npm install
npm run build

(Skip this step if you don’t use Node.js in the project.)

3. Configure Environment

Copy the example environment file and update settings:

cp .env.example .env

Edit the .env file and set up your database and other configuration variables.

4. Generate Application Key

Run the following command to generate an app key (Laravel projects):

php artisan key:generate

5. Set File Permissions

Make sure the following directories are writable by the web server:

chmod -R 775 storage
chmod -R 775 bootstrap/cache

6. Run Database Migrations

Set up the database tables:

php artisan migrate

7. Start the Application

You can now run the application using your web server. For local development, use:

php artisan serve

Visit http://localhost:8000 in your browser.

8. (Optional) Seed the Database

If you have seeders:

php artisan db:seed

Troubleshooting

• Check the .env file for correct configuration.
• Review server and PHP error logs for issues.
• Ensure all required PHP extensions are installed.

Support

For help or questions, open an issue on GitHub or refer to the Wiki.