How to Install Shopware CE on FreeBSD 11
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:
ctypecurldomhashiconvgdjsonmbstringopensslsessionsimplexmlxmlzipzlibpdo/mysql
- Nginx or Apache with
mod_rewriteenabled. 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.