Top

Installation

This page has all the information you will need to set up your project. Here, you will get to know what the things are that you will need to install before you start working on project. Make sure you don't miss a single step.

Note: To proceed with installation First, make sure you meet all Server requirements.

Composer Installation

Composer is already in your system then you don't need to do this step.

For Windows

To install Composer on your system, follow the link https://getcomposer.org/ and once it is open.

Go to Download -> Composer-Setup.exe, click this link to download.

composer -v

Verify that your system has Composer installed using the above command.

For Linux

Step 1 : Updating System

Open the terminal and update your system by running the following command on your terminal.

sudo apt-get update

If you haven't installed it, be sure to install it first.

Step 2 : Install composer

Although you already have composer installed in your system, as it is included while installing any linux based os, but if it is not included run the following command to install composer.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '55ce33d7678c5a611085589f1f3ddf8b3c52d662cd01d4ba75c0ee0459970c2200a51f492d557530c71c15d8dba01eae') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

Now, You need to add the composer.phar file to a PATH directory through this command:

sudo mv composer.phar /usr/local/bin/composer

Check the version of composer through this below command:

composer -v

Setting Up Riho

Now that you have installed composer in your system, its time to setup the Riho theme and start creating you wonderful website.

Note: Make sure you comply with all pre-requisites.

Step 1: Check PHP Version

php -v

Ensure to install it first, if it is not installed. The latest version 8.2 must be installed.

Step 2 : Check Composer Version

composer -v

If you don't have it installed, you'll need to install it first. Follow the instructions that I gave you above.

Step 3 : Install dependencies

Open the terminal or command prompt and navigate to the folder where you have stored the downloaded Riho project.

composer update

Step 4 : Environment Settings

Added the required database credentials in .env

Add values to the below keys in the .env file

If you don't have a .env file, copy the .env.example file and rename it to .env.

If you're running your Laravel project on your own computer (localhost), make sure to use localhost with current running port and put in APP_URL. as a given example below.
If you want to install on live server, you need to add your live server Riho_laravel url like a APP_URL=https://your-domain.com.

APP_URL=https://localhost:8000
DB_DATABASE=database_name
DB_USERNAME=database_username
DB_PASSWORD=database_password

Note : Make sure to set the APP_URL correctly. If you don't, features like uploading, downloading, and showing images won't work properly. Be sure to double-check and make sure everything is set up correctly.

Step 5 : generate the key

php artisan key:generate

Step 6 : Run database migration

php artisan migrate

Step 7 : Run Database Seeder

After successfully running the migration command, execute the seeder command to seed the role and user data.

php artisan db:seed

Step 8 : Link Storage folder to Public folder

Run following command to store and display images correctly.

php artisan storage:link

Step 9 : run the project

Now that all the dependencies are installed we are ready to run our project in the development server. Run the following command in the terminal:

php artisan serve

Once you serve your application by default it will take their defalult port so you can open port using example, open the link http://127.0.0.1:8000 or https://your-domain.com in your browser to view the project.