Site Logo
Buy Now
  • Overview
  • Introduction
  • Folder structure
  • Installation
  • Installing, Updating & Activating
  • Server side rendering(Optional)
  • Admin panel in Subdomain(Optional)
  • Install and update in VPS server(Optional)
  • Install SSL in VPS server(Optional)
  • Registration & login
  • SMTP configuration
  • Login with Google
  • Login with Facebook
  • Configuration & setup
  • Translate/Multi Language
  • Countries & Currency List
  • PWA Configuration
  • File upload
  • Frontend
  • API configuration
  • Google cloud storage(Optional)
  • Payment gateway
  • Paypal
  • Stripe
  • Razorpay
  • Ishop setup
  • Admin panel

How to Update in VPS server(Optional)

  1. Open the package folder
  2. You will find Update_Docker.zip file here.
  3. Unzip the Update_Docker.zip file in the root your server
  4. Now please run the following command in order to build and run the project. sudo docker-compose up -d --build
  5. Yor site will be updated

How to Install in VPS server(Optional)

Installing in VPS server is fully optional. You can skip this page if you don't have any knowledge on Docker.

Requirements

Server must have these pre installed:

  • Unzip
  • Docker
  • Docker compose

Please create a machine and SSH to your machine.

Process of creating a machine varies server to server. If you are unable to figure out the process, please contact the support team of your server. They will help you to create a machine and tell you the process of the SSH.

Unzip

Please run the following command in order to install unzip

sudo apt-get install unzip

Docker

Please run the following command in order to install docker

sudo apt update
sudo apt install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable"
sudo apt update
apt-cache policy docker-ce
sudo apt install docker-ce

If this command fails to install docker, please run following two commands then try to run the command again.

curl -O https://download.docker.com/linux/debian/dists/buster/pool/stable/amd64/containerd.io_1.4.3-1_amd64.deb
sudo apt install ./containerd.io_1.4.3-1_amd64.deb
sudo apt install docker-ce
sudo systemctl status docker

Docker compose

Please run the following command in order to install docker compose

sudo curl -L https://github.com/docker/compose/releases/download/1.21.2/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
docker-compose --version

Installing the app

After installing those apps please follow these steps.

  1. Make zip from Docker.
  2. Upload it to your server.
  3. unzip it.
    4. unzip Docker.zip
  4. Go to the project by running the following command.
    5. cd Docker

User adding for docker

Now please run the following command in order to add as user for the docker.

sudo groupadd docker
sudo usermod -aG docker $USER

Backend configuration

  1. Now open the .env file by running the following command.
    2. nano .env
  2. Change the value of APP_URL and CLIENT_BASE_URL.
    • APP_URL: URL of your admin panel. eg. http://admin.yourdomain.com
    • CLIENT_BASE_URL: URL of your frontend. eg. http://www.yourdomain.com
  3. Now save the file by running the following commands.
    4. Type ctrl + x
    Type Shift + y
    Press Enter

Frontend Configuration

  1. Please go back to the root of the project by running the following command.
    2. cd ..
  2. Now please run the following command in order to go inside the frontend folder.
    3. cd frontend
  3. Now open the .env file by running the following command
    4. nano .env
  4. Change the API_BASE form .env file
    • API_BASE: Root Url of your admin panel. eg. http://www.yourdomain.com
  5. Please don't forget to add / at the end of the URL
  6. Now save the file by running the following commands.
    7. Type ctrl + x
    Type Shift + y
    Press Enter

NGINX Configuration

  1. Please go back to the root of the project by running the following command.
    2. cd ..
  2. Now run the following command in order to go inside the nginx configuration folder.
    3. cd nginx/config
  3. Now edit the default.conf file by running.
    4. nano default.conf
  4. Navigate through Down arrow and find server_name. You will find the server_name in two places.
  5. Put your domain url in the first occurrence
  6. Put your admin url in the second occurrence
  7. Now save the file by running the following commands.
    8. Type ctrl + x
    Type Shift + y
    Press Enter

Setting permission to the storage folder

Now please run the following command in order to go inside the backend folder.

cd backend

Now please run the following command in order to set permission to storage folder.

sudo chown -R $USER:www-data storage
chmod -R 775 storage
sudo chown -R $USER:www-data bootstrap/cache
chmod -R 775 bootstrap/cache
sudo chmod -R 777 public/uploads

Run and build docker

Now please run the following command in order to build and run the project.

sudo docker-compose up -d --build

Database migration and passport install

  1. Now its time to run the database migrations in the backend. Please Run the following command to start to go to the app image:
    2. docker-compose exec app bash
  2. Please Clear the cache by running these commands:
    3. php artisan route:cache
    php artisan route:clear
    php artisan config:cache
    php artisan config:clear
    php artisan cache:clear
    php artisan optimize
  3. Run the migration by running these commands:
    4. php artisan migrate:fresh --seed
    php artisan passport:install
  4. Please Clear the cache one last time by running the commands above (Step: 2).
  5. Please exit from the container
    6. exit

Rebuild and run docker

  1. Please go back to the root of the project by running the following command.
    2. cd ..
  2. Now please run the following command in order to build and run the project.
    3. sudo docker-compose down
    sudo docker-compose up -d --build
  3. You can access the website and the admin panel from the URL in the browser now. eg. http://yourdomain.com and http://admin.yourdomain.com
  4. Use these credentials below to login to the admin panel
    • Admin email: admin@mail.com
    • Admin password: 123456
  5. Please Clear the cache one last time by running the commands above (Last paragraph, Step: 2).

If you find any difficulty installing, please do visit this link

© 2024 - All rights reserved by Ishop