# How to install as New Laravel Project
## Prerequisites
Before proceeding with the installation, make sure you have the following prerequisites:
1. PHP (version 8.1 or higher)
2. Composer (Dependency Manager for PHP)
3. MySQL or any other compatible database server
## Quick Installation
To Quickly install the system run the following command.
```
composer create-project mybizna/setup mybizna
```
## Step By Step Installation
### Step 1
Create a new Laravel project Open your terminal or command prompt and navigate to the directory where you want to create your Laravel ERP project. Run the following command to create a new Laravel project:
```
composer create-project laravel/laravel:^9.0 mybizna
```
### **Step 2**
Navigate to the project directory Change into the project directory using the following command:
```
cd mybizna/
```
### Step 3
Install the required package To install the Laravel ERP package, run the following command:
```
composer require mybizna/account
```
### Step 4
Configure the database Open the `.env` file in the root directory of your project and modify the following lines to match your database credentials:
```
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=[Your_DB_Name]
DB_USERNAME=[Your_DB_Username]
DB_PASSWORD=[Your_DB_Password]
CACHE_DRIVER=database
SESSION_DRIVER=database
SESSION_DOMAIN=
SANCTUM_STATEFUL_DOMAINS=
```
### Step 5
Edit the User model Open the `app/Models/User.php` file and add the following lines inside the `protected $fillable` array:
```
'username',
'is_admin',
'phone',
```
### Step 6
Add class and trait to the User model Add the following lines at the top of the `app/Models/User.php` file:
```
use Spatie\Permission\Traits\HasRoles;
```
Inside the `User` model class, add the following line:
```
use HasRoles;
```
### Step 7
Publish the following;
php artisan cache:table
php artisan session:table
php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider"
php artisan vendor:publish --provider="Mybizna\Assets\Providers\MybiznaAssetsProvider"
php artisan vendor:publish --provider="Spatie\Permission\PermissionServiceProvider"
* 1 is for generating the **cache** table used in managing system cache.
* 2 is for generate the **session** table used for managing system session using database.
* 3 is for publishing **santrum** migration files to be used to login to Mybizna ERP API.
* 4 is for publishing assets and database migration for adding username, phone, and email to the **users** table in the database.
* 5 is for publishing permissions configuration provided by the **Spatie/Permission** package.
Add Sanctum's middleware to your `api` middleware group within your application's `app/Http/Kernel.php` file:
```
'api' => [
\Laravel\Sanctum\Http\Middleware\EnsureFrontendRequestsAreStateful::class,
'throttle:api',
\Illuminate\Routing\Middleware\SubstituteBindings::class,
],
```
### Step 8
Run database migrations To create the necessary database tables, run the following command:
```
php artisan automigrator:migrate
```
### Step 9
Create a dummy user called ***John Doe*** Using tinker:
```
php artisan tinker
$user = new App\Models\User();
$user->password = Hash::make('johndoe');
$user->email = 'johndoe@johndoe.com';
$user->name = 'John Doe';
$user->is_admin = 1;
$user->username = 'johndoe';
$user->phone = '0723232323';
$user->save();
```
### Step 10
Enable Laravel ERP modules Enable the Laravel ERP modules using the following command:
```
php artisan module:enable
```
### Step 11
Run additional Laravel ERP migrations Run the following command to perform additional migrations specific to Laravel ERP:
```
php artisan mybizna:dataprocessor
```
### Step 12
Generate an application key Generate an application key by running the following command:
```
php artisan key:generate
```
### Step 13
Start the development server Start the Laravel development server using the following command:
```
php artisan serve
```
open the link
Login using Username: johndoe and Password johndoe
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://mybizna.gitbook.io/mybizna-erp/readme/how-to-install-in-laravel/how-to-install-as-new-laravel-project.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.