How to Install Shopware CE on FreeBSD 11

<?xml encoding="utf-8" ??>

Shopware is an open source eCommerce platform for online businesses. Shopware source code is hosted on Github. This guide will show you how to install Shopware Community Edition (CE) on a fresh FreeBSD 11 Vultr server instance.

Requirements

Minimum requirements of Shopware are:

• PHP version 5.6.4 or above with the following extensions:

  • ctype
  • curl
  • dom
  • hash
  • iconv
  • gd
  • json
  • mbstring
  • openssl
  • session
  • simplexml
  • xml
  • zip
  • zlib
  • pdo/mysql
• Nginx or Apache with mod_rewrite enabled. This guide will use Nginx.
• MySQL version 5.5.0 or above.
• IonCube Loader version 5.0. Optional, but recommended.

Before you begin

Check the FreeBSD version.

uname -ro
# FreeBSD 11.2-RELEASE

Ensure that your FreeBSD system is up to date.

freebsd-update fetch install
pkg update && pkg upgrade -y

Install sudo, vim, unzip, wget and bash packages if they are not present on your system.

pkg install -y sudo vim unzip wget bash

Create a new user account with your preferred username (we will use johndoe).

adduser

# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!

Run the visudo command and uncomment the %wheel ALL=(ALL) ALL line, to allow members of the wheel group to execute any command.

# Uncomment by removing the hash (#) sign
%wheel ALL=(ALL) ALL

Now, switch to your newly created user with su command.

su - johndoe

NOTE: Replace johndoe with your username.

Set up the timezone.

sudo tzsetup

Install PHP

Install PHP, as well as the necessary PHP extensions.

sudo pkg install -y php72 php72-ctype php72-curl php72-dom php72-hash php72-iconv php72-gd php72-json php72-mbstring php72-openssl php72-session php72-simplexml php72-xml php72-zip php72-zlib php72-pdo php72-pdo_mysql php72-filter php72-ftp php72-tokenizer php72-calendar php72-pecl-APCu php72-opcache

Check the version.

php --version
# PHP 7.2.10 (cli) (built: Oct  2 2018 01:30:18) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
#     with Zend OPcache v7.2.10, Copyright (c) 1999-2018, by Zend Technologies

Soft-link php.ini-production to php.ini.

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

Enable and start PHP-FPM.

sudo sysrc php_fpm_enable=yes
sudo service php-fpm start

Install IonCube Loader

Download IonCube Loader.

cd /tmp && wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_fre_11_x86-64.tar.gz

Extract the loader.

tar xfz ioncube_loaders_fre_*.tar.gz

Find the PHP extensions directory on the system by running the commands below.

php -i | grep extension_dir
# extension_dir => /usr/local/lib/php/20170718 => /usr/local/lib/php/20170718

Copy the IonCube Loader into the PHP extensions directory.

sudo cp /tmp/ioncube/ioncube_loader_fre_7.2.so /usr/local/lib/php/20170718

Open the PHP configuration file.

sudo vim /usr/local/etc/php.ini

Then, add a line to the file to include the loader. It can be anywhere in the file below the [PHP] line.

zend_extension = /usr/local/lib/php/20170718/ioncube_loader_fre_7.2.so

Save the file and restart PHP-FPM.

sudo service php-fpm restart

Install MariaDB and setup the database

Download and install MariaDB.

sudo pkg install -y mariadb102-client mariadb102-server

Check the version.

mysql --version
# mysql  Ver 15.1 Distrib 10.2.17-MariaDB, for FreeBSD11.2 (amd64) using readline 5.1

Enable and start MariaDB.

sudo sysrc mysql_enable="yes" 
sudo service mysql-server start

Run the mysql_secure_installation script to improve the security of your installation.

sudo mysql_secure_installation

Log in to MariaDB as the root user.

sudo mysql -u root -p
# Enter password:

Create a new database and user, and remember the credentials.

CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;

Exit MariaDB.

exit

Install and configure Nginx

Install Nginx.

sudo pkg install -y nginx

Check the version.

nginx -v
# nginx version: nginx/1.14.0

Enable and start Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Run sudo vim /usr/local/etc/nginx/shopware.conf and configure Nginx for Shopware.

server {

  listen 80;
  listen [::]:80;

  server_name example.com; # Check this
  root /usr/local/www/shopware; # Check this

  index shopware.php index.php;

  location / {
    try_files $uri $uri/ /shopware.php$is_args$args;
  }

  location /recovery/install {
    index index.php;
    try_files $uri /recovery/install/index.php$is_args$args;
  }

  location ~ \.php$ {
    fastcgi_pass 127.0.0.1:9000; # Check this
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
   }

}

Save the file and exit with :+W+Q.

Now we need to include shopware.conf in the main nginx.conf file.

Run sudo vim /usr/local/etc/nginx/nginx.conf and add the following line to the http {} block.

include shopware.conf;

Test the configuration.

sudo nginx -t

Reload Nginx.

sudo service nginx reload

Install Shopware

Create a document root directory.

sudo mkdir -p /usr/local/www/shopware

Change ownership of the /usr/local/www/shopware directory to johndoe.

sudo chown -R johndoe:johndoe /usr/local/www/shopware

Download the latest release of Shopware.

cd /usr/local/www/shopware
wget http://releases.s3.shopware.com.s3.amazonaws.com/install_5.5.1_4a48054b7c53187c807d6a6d82ec88ffb72b5e6a.zip?_ga=2.55824683.1277098894.1539887145-1483950935.1538544950 -O shopware.zip
unzip shopware.zip
rm shopware.zip

NOTE: Update the download link in the command above if there is a newer release.

Change ownership of the /usr/local/www/shopware directory to www.

sudo chown -R www:www /usr/local/www/shopware

Open the /usr/local/etc/php.ini file.

sudo vim /usr/local/etc/php.ini

Increase memory_limit = 256M and upload_max_filesize = 6M, and set allow_url_fopen = On if it is not already set.

After making changes in the /etc/php/7.2/fpm/php.ini file, reload php-fpm.service

sudo service php-fpm reload

Open your domain/IP in the web browser and follow the installation wizard. The backend of Shopware is located at /backend example: http://example.com/backend.

You have successfully installed Shopware.