Table of Contents
Was this article helpful?
Try Vultr Today with

$50 Free on Us!

Want to contribute?

You could earn up to $600 by adding new articles.

How to Install Shopware CE on Debian 9

Last Updated: Fri, Nov 30, 2018
Business Debian Linux Guides Server Apps
Archived content

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)

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

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/ /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/

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; # 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 -O



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:

You have successfully installed Shopware. Enjoy your new online shop.

Want to contribute?

You could earn up to $600 by adding new articles.