Install Shopware: Complete Guide

The official guide to installing Shopware 6 offers a detailed and clear path to getting your e-commerce platform up and running. Here is a summary of the main steps for installing on a Linux hosting environment, including specific commands you may need during the process. This guide assumes you have SSH access to your server and have already set up a LAMP (Linux, Apache, MySQL, PHP) or LEMP (Linux, Nginx, MySQL, PHP) environment.

Steps for Installing Shopware 6

1. Preparation of the Environment Before you begin, make sure your server meets the minimum system requirements for Shopware 6. These include:

   • PHP 7.4 or higher
   • MySQL 5.7.21 or higher or MariaDB 10.3 or higher
   • Apache 2.4 or Nginx
   • The PHP extension intl, gd, opcache, pdo_mysql, json, curl, mbstring, xml, and zipper must be enabled.

2. Downloading Shopware Connect to your server via SSH and navigate to the directory where you wish to install Shopware. You can download the latest version of Shopware using wget or curl. For example:

   cd /var/www/html wget https://www.shopware.com/en/Download/redirect/version/sw6/file/install_v6.4.5.1_1660750754.zip

3. Shopware Archive Extraction Once the download is complete, extract the contents of the zipper archive to your web directory. You can do this with the following command:

   unzip install_v6.4.5.1_1660750754.zip

4. Database Creation Before proceeding with the web installation, you need to create a database for Shopware. Log on to your MySQL or MariaDB and create a database and a user with the necessary privileges. For example:

   mysql -u root -p
   CREATE DATABASE shopware;
   CREATE USER 'shopware'@'localhost' IDENTIFIED BY 'password';
   GRANT ALL PRIVILEGES ON shopware.* TO 'shopware'@'localhost';
   FLUSH PRIVILEGES;
   EXIT;

5. Web Server Configuration

   • • For Apache: Make sure the rewrite module is enabled and configure your virtual host to point to Shopware's public (public) directory.

    
    ServerName "_HOST_NAME_"
    DocumentRoot _SHOPWARE_DIR_
   
     
     Options Indexes FollowSymLinks MultiViews
     AllowOverride All
     Order allow,deny
     allow from all
     
   
    ErrorLog ${APACHE_LOG_DIR}/shopware-platform.error.log
    CustomLog ${APACHE_LOG_DIR}/shopware-platform.access.log combined
    LogLevel debug 
   

   Keep in mind that the DocumentRoot in the example above does not point to the folder /public in the Shopware 6 installation directory. Inside the public folder are the user frontend files and the administration interface, but both features are available only after you complete the installation. So, once the installation is complete, you need to direct the DocumentRoot a SHOPWARE_DIR/public. This is necessary so that your customers do not have to access the store via https://shop.marcorinaldi.us/public, for example. Shopware 6 will notify you of this need after installation.

    

6. For Nginx: You will need to add a specific configuration for Shopware in your Nginx server configuration. You can find an example configuration below.

   server {
       listen 80;
       server_name shopware.yourdomain.com;
       index index.php;
       client_max_body_size 128M;
       root /var/www/html/shopware/public;
   
   location /recovery/install {
       index index.php;
       try_files $uri /recovery/install/index.php$is_args$args;
       }
   
   location /recovery/update/ {
      location /recovery/update/assets {
      }
      if (!-e $request_filename){
         rewrite . /recovery/update/index.php last;
      }
   }
   
   
   location / {
       try_files $uri /index.php$is_args$args;
       }
   
   
   location ~ ~ \.php$ {
       fastcgi_split_path_info ^(.+\.php)(/.+)$;
       include fastcgi.conf;
       fastcgi_param HTTP_PROXY "";
       fastcgi_buffers 8 16k;
       fastcgi_buffer_size 32k;
       fastcgi_read_timeout 300s;
       client_body_buffer_size 128k;
       fastcgi_pass unix:/run/php/php8.1-fpm.sock;
       http2_push_preload on;
       }
   }

    

Installation via Web Interface

After setting up the web server, open your browser and go to the URL of your Shopware site. You will be redirected to the Shopware installation assistant. Follow the instructions provided by the assistant:

• • Agree to the terms and conditions.
  • Fill in the database details with the data from the database you created earlier.
  • Configure administrative information for your Shopware store.
  • Complete the installation.

Conclusion of Installation

Once the installation is complete via the web interface, you will be able to access the Shopware backend using the credentials you configured during installation. From here, you can start customizing your store, adding products and configuring settings as needed.

By following these steps, you will be able to install Shopware 6 on your Linux hosting server and start building your e-commerce site. Remember to always consult the official documentation for the most up-to-date instructions and server-specific configurations.