In this tutorial, we’ll go over the steps needed to install Open eShop on an Ubuntu 18.04 VPS.
Open eShop is a free and open-source PHP-based web interface that allows its users to easily sell their digital goods such as MP3s, eBooks, Movies, Software, or any other downloadable item on offer. The installation of Open eShop is pretty easy, and this tutorial will go into details on how to install and configure Open eShop on an Ubuntu 18.04 VPS with Apache web server, MySQL database server and PHP.
Some of the main Open eShop features are listed below:
- Different payment methods supported – Paypal or credit or debit card (using Paymill, Stripe, and Bitpay). The products are only downloadable by paid users.
- Create discount coupons with unique codes and limits
- Integrated customer support system with easy interface
- Fully mobile-friendly
- Fully customizable with themes and widgets
and much more..
Let’s begin with the installation.
Table of Contents
- VPS with Ubuntu 18.04 OS
- LAMP stack
- System user with root privileges, or access to the root user itself
Step 1: Log in and Update the Server
Login to your Ubuntu 18.04 server via SSH as the root user (or as an admin account):
ssh root@IP_Address -p Port_number
Don’t forget to replace ‘IP_Address‘ and ‘Port_number‘ with your server’s actual IP address and SSH port number.
and run the following command to update all installed packages on your server:
apt update && apt upgrade
Step 2: Install the Apache Web Server
In order to run Open eShop, a web server is required. We will install and use the Apache web server, which is the most popular web server in the world. It can be easily installed using the following command:
apt -y install apache2
Once it is installed, start the web server and enable it to automatically start after a server reboot:
apt start apache2 apt enable apache2
Step 3: Install PHP
Open eShop is built entirely in PHP, so we have to install PHP and several PHP modules on our server.
apt install php libapache2-mod-php php-cli php-soap php-zip php-curl php-mbstring php-gd php-common php-json php-mysql php-opcache
Since the Mcrypt PHP extension is not available in PHP 7.2, but is required by Open eShop, we will have to install few additional packages in order to install the extension with
apt-get install php-dev libmcrypt-dev gcc make autoconf libc-dev pkg-config pecl install mcrypt-1.0.1 echo "extension=mcrypt.so" | sudo tee -a /etc/php/7.2/apache2/conf.d/mcrypt.ini
Then restart the web server for the changes to take effect:
systemctl restart apache2
Step 4: Install the MySQL Database Server
Open eShop needs an empty database in which it’ll store its information. For this purpose we will install the MySQL database server:
apt install mysql-server
Start MySQL and enable it to automatically start upon a reboot:
apt start mysql apt enable mysql
To improve the security of the MySQL database server and set up a password for the MySQL root user, you can run the
mysql_secure_installation post installation script, which is included with the MySQL package. You can use the following text as a guide (we suggest answering with ‘Y’ for yes to all prompts):
Remove anonymous users? (Press y|Y for Yes, any other key for No) : Y Disallow root login remotely? (Press y|Y for Yes, any other key for No) : Y Remove test database and access to it? (Press y|Y for Yes, any other key for No) : Y Reload privilege tables now? (Press y|Y for Yes, any other key for No) : Y
Step 5: Create a MySQL User and Database
Now that we have the MySQL database server installed and running, next we can create the new user and database that are needed for Open eShop. Log in to the MySQL CLI as the root user using the password you set earlier in this tutorial when going through the secure installation setup. If you chose not to set that up, the root password is blank, so when prompted, just press the [Enter] key to authenticate.
mysql -u root -p mysql> CREATE DATABASE eshop; mysql> GRANT ALL PRIVILEGES ON eshop.* TO 'eshop_user'@'localhost' IDENTIFIED BY 'PASSWORD'; mysql> FLUSH PRIVILEGES; mysql> exit;
Replace ‘PASSWORD‘ with a strong password.
Step 6: Download Open eShop
Create a directory for Open eShop inside the document root diretory.
mkdir /var/www/html/openeshop && cd $_
And download Open eShop’s installation script
All Open eShop files have to be readable by the web server user, so we’ll need to change the permissions of those files:
chow -R www-data:www-data /var/www/html/openeshop
Step 7: Create an Apache Virtual Host
In order to be able to access Open eShop with your domain name, you’ll have to create an Apache virtual host directive for the specific domain name. Create a configuration file with your preferred text editor (we use nano):
Then enter the following contents:
Listen 80 <VirtualHost *:80> ServerAdmin admin@your_domain.com DocumentRoot /var/www/html/openeshop DirectoryIndex install-eshop.php ServerName
www.your_domain.comOptions Indexes FollowSymLinks MultiViews AllowOverride All Order allow,deny allow from all ErrorLog /var/log/apache2/your_domain.com-error_log CustomLog /var/log/apache2/your_domain.com-access_log common </VirtualHost>
Replace ‘your_domain.com‘ with your unique registered domain name.
Enable the virtual host and restart Apache:
a2ensite openeshop systemctl restart apache2
Step 8: Complete the installation
Open eShop requires the ‘short_open_tag’ PHP directive to be enabled, so open the PHP configuration file as shown below and make the necessary changes:
Make sure there’s a line in the file that looks identical to this:
short_open_tag = on
Then save and exit the file.
Enable the Apache mod_rewrite module:
and restart the Apache web server for the changes to take effect
systemctl restart apache2
At this point you should be able to access Open eShop with your favorite web browser at
http://yourdomain.com . The installation wizard will check if all requirements are met before starting the installation, as shown below:
Click the ‘Download and Install’ button to complete the Open eShop installation. Congratulations! You have finished with the installation of Open eShop.
Fore more information on how to use and configure this application, please check their official documentation.
Of course, if you are one of our Managed Ubuntu Hosting customers, you don’t have to install Open eShop on your Ubuntu 18.04 VPS – simply ask our admins, sit back, and relax. Our admins will install Open eShop on Ubuntu 18.04 for you immediately.
PS. If you liked this post about how to install Open eShop on an Ubuntu 18.04 VPS, please share it with your friends on the social networks using the buttons below, or simply leave a comment in the comments section. Thanks.