How to Install OXID eShop on MXLinux Latest

This tutorial will guide you through the steps to install OXID eShop on MXLinux using the download from https://oxidforge.org/en/.

Prerequisites

Before you begin, ensure you have the following prerequisites:

  • A running installation of MXLinux Latest

  • Sudo privileges on the system

Step 1 - Download OXID eShop

To begin, we need to download the OXID eShop package from the official website. You can do this by heading to the download section of https://oxidforge.org/en/ and selecting the package that is suitable for your installation.

Once the file has downloaded, you should have a file named "OXID-eShop-version.tar.gz" in your Downloads folder.

Step 2 - Extract the OXID eShop package

Next, we need to extract the files from the downloaded package.

  1. Open the terminal by pressing "CTRL + Alt + T"
  2. Navigate to the Downloads directory by executing cd ~/Downloads
  3. Extract the package using the command tar -xzvf OXID-eShop-version.tar.gz

Step 3 - Move the package to the Apache2 web server root directory

Now that the package is extracted, we need to move the contents of the package to the web server's root directory. In this tutorial, we are using the default Apache2 web server root directory at /var/www/html/, so we will be placing the OXID eShop files there.

  1. Navigate to the directory where the package was extracted by executing cd OXID-eShop-version/
  2. Move the contents of the package to the Apache2 web server root directory using the command sudo cp -r * /var/www/html/

Step 4 - Set up file permissions

Now that the files are in place, we need to set up the proper file permissions for OXID eShop to function properly.

  1. Navigate to the Apache2 web server root directory by executing cd /var/www/html/
  2. Change the ownership of the directory to the web server user using the command sudo chown -R www-data:www-data *
  3. Change permissions of the directories and files using the command sudo chmod -R 755 *
  4. Change permissions on the config_inc.php file using the command sudo chmod 664 config_inc.php

Step 5 - Configure the database

Before we can run OXID eShop, we need to configure the database.

  1. Create a new database by executing sudo mysql -u root -p -e "CREATE DATABASE oxid"
  2. Create a new user for the database by executing sudo mysql -u root -p -e "GRANT ALL PRIVILEGES ON oxid.* TO 'oxiduser'@'localhost' IDENTIFIED BY 'password'". Replace password with a secure password of your choice.

Step 6 - Launch OXID eShop installer

Now that the database is set up, you can launch the OXID eShop installer.

  1. Navigate to the OXID eShop directory by executing cd /var/www/html/
  2. Launch the installer by executing sudo php setup/index.php
  3. Follow the prompts in the installer to configure the shop. When prompted, enter the database information created in step 5.

Congratulations, OXID eShop is now installed on MXLinux Latest and is ready to use.