Learn How To Install Shopware CE on Debian 9

September 30, 2019

Table of Contents

If you are using a different system, please check our other tutorials.

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 IT Web Services 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)

Before you begin

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

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

Install IonCube Loader

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 and setup the database

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.

GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';

Install and configure Nginx

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

Install Shopware

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.

Need help?

Do you need help setting up this on your own service?
Please contact us and we’ll provide you the best possible quote!