# Shopware 6

For the right Shopware-specific configuration files or commands, make sure to double-check everything with the Shopware Developer Docs for your specific Shopware version.

[!ref Shopware Developer Docs](https://developer.shopware.com/)

## Basic stack for Shopware 6
For Shopware 6 our basic recommended stack looks like this. This is also the basis on which the ‘extended’ stack builds.

- Nginx
- MySQL 8 (Percona)
- PHP 8.5
  + Plus extensions as required by Shopware

This stack allows you to run your small Shopware 6 projects.

The minimal config looks like this. Make sure to customize the app name, usernames, email addresses and domain names everywhere.
```yaml
users:
  - appname

webserver:
  enable: true
  type: nginx

php:
  enable: true
  extra_packages:
    - gd
    - intl
    - mbstring
    - amqp
    - redis
    - ctype
    - curl
    - dom
    - fileinfo
    - gd
    - iconv
    - intl
    - mysql
    - phar
    - simplexml
    - xml
    - zip
    - ftp

mysql:
  enable: true
  version: '8.0'

apps:
  - name: appname
    type: php
    subtype: shopware6
    domain: appname.com
    php_version: '8.5'
    cert: "letsencrypt"
    letsencrypt_email: "me@example.com"
    web_root: /var/www/appname/current/public
    backup_dirs:             # directories to include in daily file backups
      - /var/www/appname/shared
    database:
      name: appname
      user: appname

ssh_keys:
  - your public ssh key
```

The first time this stack is deployed, following configuration files will be created:
- `~/.config/nginx/10main.conf`
    This contains a Shopware-optimized nginx template.

### Credentials
Any credentials necesary to use the enabled services can be accessed from your SSH user. Run the `ploy credentials` command.

---
## Nginx
The Shopware 6 stack ships with a nginx template optimized for Shopware. It contains additional headers for browser caching of static assets, improved log handling, ...

You are free to customize this configuration as needed. 
Read more on the nginx page for more infromation about customizing the nginx config.
[!ref](/webserver/nginx)

---
## Redis
Use the guide on Redis to set up Redis on your Ploy.sh environment.
[!ref](/database/redis)

Additionally, add the following configuration to your Shopware 6 project to use redis correctly: <a href="https://developer.shopware.com/docs/guides/hosting/infrastructure/redis.html#redis" target="_blank">Shopware Developer Docs: Infrastructure Redis</a>

```
... tbc
```

---
## Elasticsearch / OpenSearch
[!ref](/database/elasticsearch)
[!ref](/database/opensearch)

---
## Systemd
**Systemd** is a service manager used by many Linux systems to start, stop, and manage background processes automatically. 
[!ref](/system/systemd)

To run certain Shopware tasks reliably, you need to create systemd service files. These files tell systemd how to run your scheduled tasks and message workers.

The required files are:

- `~/.config/systemd/user/shopware-scheduled-task.service` – Configures systemd to execute the scheduled tasks command automatically.  
```ini
[Unit]
Description=Shopware scheduled tasks
After=network-online.target
StartLimitIntervalSec=0
Requires=dbus.socket
PartOf=shopware.target

[Service]
Type=simple
Restart=always
RestartSec=10s
WorkingDirectory=%h/current
ExecStart=/usr/bin/php %h/current/bin/console scheduled-task:run --memory-limit=128M --time-limit=300

[Install]
WantedBy=default.target
```

- `~/.config/systemd/user/shopware-message-consume@.service` – Configures systemd to run a Messenger consume worker.  
```ini
[Unit]
Description=Shopware Message Queue Consumer (#%i)
After=network-online.target
Requires=dbus.socket
StartLimitIntervalSec=0
PartOf=shopware.target

[Service]
Type=simple
WorkingDirectory=%h/current
ExecStart=php %h/current/bin/console messenger:consume --time-limit=600 --memory-limit=256M async low_priority
RestartSec=10s
Restart=always

[Install]
WantedBy=default.target
```

- `~/.config/systemd/user/shopware.target` – Controls how many message worker instances should be started.  
```ini
[Unit]
Description=Shopware Workers
Wants=shopware-message-consume@1.service shopware-message-consume@2.service shopware-scheduled-task.service

[Install]
WantedBy=default.target
```

Once these files are in place, systemd can manage these processes in the background, keeping your environment running smoothly.

To enable and start your **systemd** user services on Linux, follow these steps. These commands assume your service files are located in `~/.config/systemd/user/`.

### 1. Reload systemd to recognize new service files
```bash
systemctl --user daemon-reload
```

### 2. Enable services to start automatically on login
```bash
systemctl --user enable shopware.target
```

### 3. Start the services
```bash
systemctl --user start shopware.target
```

### 4. Check the services status
```bash
systemctl --user status shopware-scheduled-task.service
systemctl --user status shopware-message-consume@1.service 
systemctl --user status shopware-message-consume@2.service 
```