Guide to Install Admin on Linux

This guide will help you install the Investra admin panel on your Linux machine. The admin panel is built using Laravel.

Prerequisites

Before you start, make sure you have the following installed on your Linux machine:

• Apache
• MySQL
• PHP
• Composer
• Node.js

Please follow the below steps,

1. Extract the investra package that you download from CodeCanyon.
2. After that you see two zip files called 'core.zip', 'deployment.zip' and 2 folders local_deployment, documentation.
3. Now extract the core.zip file to the core folder.
4. Extract the core folder and now you will get four zip files called admin.zip, standalone-client.zip, static-client.zip and mobile.zip on core folder.

As you can see the folder structure like below,

investra
├── documentation
├── core
│   ├── admin.zip
│   ├── standalone-client.zip
│   ├── static-client.zip
│   └── mobile.zip
├── local_deployment
└── deployment.Zip 

Step 1: If you don't have Apache then Install Apache

1. Install Apache using the package manager for your Linux distribution. For example, on Ubuntu, you can install Apache using the following command:

sudo apt-get update
sudo apt-get install apache2

2. Start the Apache service and enable it to start on boot:

sudo systemctl start apache2
sudo systemctl enable apache2

3. Verify that Apache is running by visiting http://localhost/ in your web browser.

Step 2: Install MySQL

1. Install MySQL using the package manager for your Linux distribution. For example, on Ubuntu, you can install MySQL using the following command:

sudo apt-get install mysql-server

2. Start the MySQL service and enable it to start on boot:

sudo systemctl start mysql
sudo systemctl enable mysql

3. (Optional) Secure your MySQL installation by running the following command:

sudo mysql_secure_installation

4. Create a new MySQL database for your Laravel project:

5. Open a terminal window.

6. Run the following command to log in to MySQL:

mysql -u root -p

3. Enter your MySQL root password when prompted.
4. Create a new database Laravel project:

CREATE DATABASE investra_db;

5. Create a new user:

CREATE USER 'investra_user'@'localhost' IDENTIFIED BY 'password';

6. Grant the user all privileges on the database:

GRANT ALL PRIVILEGES ON investra_db.* TO 'investra_user'@'localhost';

7. Flush the privileges to ensure that the changes take effect:

FLUSH PRIVILEGES;

8. Exit the MySQL shell by running the following command:

EXIT;

Step 3: Install PHP

1. Install PHP and the required PHP extensions using the package manager for your Linux distribution. For example, on Ubuntu, you can install PHP using the following command:

sudo apt install php8.3 php8.3-curl php8.3-fileinfo php8.3-gd php8.3-bcmath php8.3-gettext php8.3-mbstring php8.3-exif php8.3-mysqli php8.3-pdo php8.3-zip -y

2. Restart the Apache service to apply the changes:

sudo systemctl restart apache2

3. Verify that PHP is installed by creating a phpinfo.php file in the Apache web root directory:

echo "<?php phpinfo(); ?>" | sudo tee /var/www/html/phpinfo.php

4. Visit http://localhost/phpinfo.php in your web browser to view the PHP information.

Step 4: Install Composer

1. Download and install Composer by running the following commands:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

or

 sudo apt-get install composer

2. Verify that Composer is installed by running the following command:

composer --version

Step 5: Install Node.js

1. Install Node.js using the package manager for your Linux distribution. For example, on Ubuntu, you can install Node.js using the following command:

sudo apt-get install nodejs

2. Verify that Node.js is installed by running the following command:

node --version

3. Install the Node.js package manager (npm) by running the following command:

sudo apt-get install npm

4. Verify that npm is installed by running the following command:

npm --version

Step 6: Setup our Admin Project

1. Extract the project files to the directory then in this folder have 2 folder documentation and core folder. Now copy the core folder to the root folder.

Note: If you are a developer please follow the below steps to install our investra project. If you are not a developer please don't use the below steps, only follow GUI steps.

2. Navigate to the project directory and install the project dependencies using Composer:

cd ~/Downloads/investra-project

3. Comment the below line on /public/index.php file:

 if (! file_exists(__DIR__.'/../storage/installed')) {
     header('Location: /installer/index.php');
     exit;
 }
//  to

// if (! file_exists(__DIR__.'/../storage/installed')) {
//     header('Location: /installer/index.php');
//     exit;
// }

composer install

4. Create a copy of the .env.example file and rename it to .env:

cp .env.example .env

5. Generate an application key by running the following command:

php artisan key:generate

6. Run the following command to migrate the database:

php artisan migrate

7. Generate the application storage link by running the following command:

php artisan storage:link

8. Generate dummy data for testing:

php artisan db:seed

9. Start the Laravel development server:

php artisan serve

10. Also start the npm server by running the following command:

npm run dev

11. Open a web browser and navigate to http://localhost:8000 to view the Admin project.

Conclusion

Congratulations! You have successfully installed investra admin on your Linux machine. You can now start customizing your application. If you have any questions, feel free to reach out to our support team. 🚀