This article is outdated and may not work correctly for current operating systems or software.
Shopware is an open source eCommerce platform for online businesses. Shopware's source code is hosted on Github. This guide will show you how to install Shopware Community Edition (CE) on a fresh Debian 9 Vultr server instance.
PHP 5.6.4 or above with the following extensions:
ctype
curl
dom
hash
iconv
gd (with freetype and libjpeg)
json
mbstring
OpenSSL
session
SimpleXML
xml
zip
zlib
PDO/MySQL
Nginx or Apache with mod_rewrite enabled, this guide will use Nginx
MySQL 5.5.0 or above
IonCube Loader version 5.0 (optional, but recommended)
Check the Debian version.
lsb_release -ds
# Debian GNU/Linux 9.4 (stretch)
Ensure that your system is up to date.
apt update && apt upgrade -y
Install necessary packages.
apt install -y sudo unzip wget curl vim
Create a new non-root user account with sudo access and switch to it.
adduser johndoe --gecos "John Doe"
usermod -aG sudo johndoe
su - johndoe
NOTE: Replace johndoe with your username.
Set up the timezone.
sudo dpkg-reconfigure tzdata
Install PHP 7.0 and required PHP extensions.
sudo apt install -y php7.0 php7.0-cli php7.0-fpm php7.0-common php7.0-mysql php7.0-curl php7.0-json php7.0-zip php7.0-gd php7.0-xml php7.0-mbstring php7.0-opcache
Check the version.
php --version
# PHP 7.0.27-0+deb9u1 (cli) (built: Jan 5 2018 13:51:52) ( NTS )
# Copyright (c) 1997-2017 The PHP Group
# Zend Engine v3.0.0, Copyright (c) 1998-2017 Zend Technologies
# with Zend OPcache v7.0.27-0+deb9u1, Copyright (c) 1999-2017, by Zend Technologies
Download IonCube Loader.
cd /tmp && wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz
Extract it.
tar xfz ioncube_loaders_lin_*.gz
Find the PHP extensions directory on the system by running the commands below.
php -i | grep extension_dir
# extension_dir => /usr/lib/php/20151012 => /usr/lib/php/20151012
Copy the ionCube Loader into the PHP extensions directory.
sudo cp /tmp/ioncube/ioncube_loader_lin_7.0.so /usr/lib/php/20151012
Include the loader via the PHP configuration.
sudo vim /etc/php/7.0/fpm/php.ini
Then add a line in the file to include ionCube loader. It can be anywhere in the file below the [PHP] line.
zend_extension = /usr/lib/php/20151012/ioncube_loader_lin_7.0.so
Save the file and restart php-fpm.
sudo systemctl restart php7.0-fpm.service
Install MariaDB.
sudo apt install -y mariadb-server
Check the version.
mysql --version && sudo mysqld --version
# mysql Ver 15.1 Distrib 10.1.26-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2
# mysqld Ver 10.1.26-MariaDB-0+deb9u1 for debian-linux-gnu on x86_64 (Debian 9.1)
Run mysql_secure installation to improve MariaDB security and set the password for the MariaDB root user.
sudo mysql_secure_installation
Connect to MariaDB shell as the root user.
sudo mysql -u root -p
# Enter password
Create an empty MariaDB database and user for Shopware, and remember the credentials.
CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
EXIT;
Install Nginx.
sudo apt install -y nginx
Check the version.
sudo nginx -v
# nginx version: nginx/1.10.3
Run sudo vim /etc/nginx/sites-available/shopware.conf and configure Nginx for Shopware.
server {
listen 80;
listen [::]:80;
server_name example.com; # Check this
root /var/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$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php7.0-fpm.sock; # Check this
}
}
Save the file and exit.
Activate the new shopware.conf configuration by linking the file to the sites-enabled directory.
sudo ln -s /etc/nginx/sites-available/shopware.conf /etc/nginx/sites-enabled/
Test the configuration.
sudo nginx -t
Reload Nginx.
sudo systemctl reload nginx.service
Create a document root directory.
sudo mkdir -p /var/www/shopware
Change ownership of the /var/www/shopware directory to johndoe.
sudo chown -R johndoe:johndoe /var/www/shopware
Download the latest release of Shopware.
cd /var/www/shopware
wget http://releases.s3.shopware.com.s3.amazonaws.com/install_5.4.5_6847c0845f0f97230aa05c7294fa726a96dda3ff.zip?_ga=2.133696968.774684214.1529926951-1771999509.1528830594 -O shopware.zip
unzip shopware.zip
rm shopware.zip
NOTE: Update the download URL if there is a newer release.
Change ownership of the /var/www/shopware directory to www-data.
sudo chown -R www-data:www-data /var/www/shopware
Increase memory_limit = 256M and upload_max_filesize = 6M, and set allow_url_fopen = On if not already set in /etc/php/7.0/fpm/php.ini.
sudo vim /etc/php/7.0/fpm/php.ini
After making changes in /etc/php/7.0/fpm/php.ini, reload php7.0-fpm.service
sudo systemctl reload php7.0-fpm.service
Open your domain/IP in a web browser and follow the installation wizard. The backend of Shopware is located at /backend: http://example.com/backend.
You have successfully installed Shopware. Enjoy your new online shop.