Skip to content

Commit 0f85bf8

Browse files
Add latest Shopware 6 install steps
Add a section on installing the latest version of Shopware 6 (6.7) with Composer, including the PHP, MySQL, Node.js and Composer requirements on Hypernode. The existing Shopware 6.0 steps are kept under their own section. Co-authored-by: yasingunaydiin <81875281+yasingunaydiin@users.noreply.github.com>
1 parent 3282295 commit 0f85bf8

1 file changed

Lines changed: 142 additions & 17 deletions

File tree

Lines changed: 142 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
22
myst:
33
html_meta:
4-
description: Shopware 6 requires a Hypernode Falcon S hosting plan or larger.
5-
We explain how you can setup the latest version of Shopware 5 on Hypernode.
6-
title: 'How to install Shopware 6 on Hypernode? '
4+
description: Learn how to install the latest version of Shopware 6 on Hypernode
5+
with Composer, or how to set up Shopware 6.0.
6+
title: How to install Shopware 6 on Hypernode?
77
redirect_from:
88
- /en/ecommerce/shopware/how-to-install-shopware-6-on-hypernode/
99
- /knowledgebase/how-to-install-shopware-6-on-hypernode/
@@ -13,45 +13,170 @@ redirect_from:
1313

1414
# How to Install Shopware 6 on Hypernode
1515

16-
This article will explain how you can setup the latest version of Shopware 6 on Hypernode as easy as possible.
16+
This article explains how you can set up Shopware 6 on Hypernode as easily as possible. It covers two situations:
1717

18-
## Upgrade Your PHP Version
18+
- [Install the latest version of Shopware 6](#install-the-latest-version-of-shopware-6). Use this for new shops.
19+
- [Install Shopware 6.0](#install-shopware-60). Use this only if you specifically need this older version.
1920

20-
Shopware 6 need at least PHP version 7.4 to be able to run. So the first thing to do is upgrade your PHP version to 7.4 with the following command:
21+
## Install the Latest Version of Shopware 6
22+
23+
The latest versions of Shopware 6 are installed with Composer. The steps below are based on Shopware 6.7.
24+
25+
### Check the Requirements
26+
27+
Shopware 6.7 has the following requirements:
28+
29+
| Software | Required version | Recommended on Hypernode |
30+
| -------- | ------------------------------------- | ------------------------ |
31+
| PHP | 8.2 or higher | 8.4 |
32+
| MySQL | 8.0.22 or higher | 8.4 |
33+
| Node.js | 20 or higher | 24 |
34+
| Composer | 2.2 or higher | 2.x |
35+
| Redis | 7.0 or higher (optional, for caching) | Redis 7 |
36+
37+
For the full list of requirements, see the [Shopware system requirements](https://developer.shopware.com/docs/guides/hosting/).
38+
39+
### Upgrade Your PHP Version
40+
41+
Change the PHP version to PHP 8.4 with the following command:
42+
43+
```bash
44+
hypernode-systemctl settings php_version 8.4
45+
```
46+
47+
### Upgrade Your MySQL Version
48+
49+
Shopware 6.7 needs at least MySQL 8.0. You can check your current MySQL version with `mysql --version`. Upgrade to MySQL 8.4 with the following command:
50+
51+
```bash
52+
hypernode-systemctl settings mysql_version --value 8.4
53+
```
54+
55+
```{important}
56+
You can only upgrade to MySQL 8.4 from MySQL 8.0, and you cannot downgrade your MySQL version afterwards. See [How to Use MySQL on Hypernode](../../hypernode-platform/mysql/how-to-use-mysql-on-hypernode.md) for the full upgrade path.
57+
```
58+
59+
### Upgrade Your Node.js and Composer Versions
60+
61+
Shopware uses Node.js to build the administration and storefront. Change the Node.js version to 24 and make sure you use Composer 2:
62+
63+
```bash
64+
hypernode-systemctl settings nodejs_version 24
65+
hypernode-systemctl settings composer_version 2.x
66+
```
67+
68+
Use `livelog` to check when the changes are applied.
69+
70+
### Create the Shopware Project
71+
72+
Create a new Shopware project in `/data/web/shopware` with Composer:
73+
74+
```bash
75+
cd /data/web
76+
composer create-project shopware/production shopware
77+
```
78+
79+
This installs the latest stable version of Shopware 6. If you need a specific version, add it to the package name, for example `shopware/production:6.7.15.1`.
80+
81+
### Configure the Database Connection
82+
83+
Shopware reads its configuration from the `.env.local` file in the project folder. Look up the password of the `app` MySQL user:
84+
85+
```bash
86+
cat ~/.my.cnf
87+
```
88+
89+
Then create the `.env.local` file:
90+
91+
```bash
92+
cd /data/web/shopware
93+
cat > .env.local <<'EOF'
94+
APP_ENV=prod
95+
APP_URL=https://APPNAME.hypernode.io
96+
DATABASE_URL=mysql://app:PASSWORD@mysqlmaster:3306/shopware
97+
EOF
98+
```
99+
100+
Replace `APPNAME` with the name of your Hypernode and `PASSWORD` with the password from `~/.my.cnf`. If the password contains special characters, such as `@`, `/` or `#`, [URL-encode](https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding) these characters.
101+
102+
### Install Shopware
103+
104+
Run the Shopware installer. The `--create-database` option creates the `shopware` database for you:
105+
106+
```bash
107+
cd /data/web/shopware
108+
bin/console system:install --basic-setup --create-database
109+
```
110+
111+
This creates the database tables, a default sales channel, and an admin user.
112+
113+
### Enable the Secure Document Root
114+
115+
The web root of Shopware is the `public` folder of the project. Point the Hypernode document root to this folder:
116+
117+
```bash
118+
rm -rf /data/web/public
119+
ln -s /data/web/shopware/public/ /data/web/public
120+
```
121+
122+
Your shop is now available at `https://APPNAME.hypernode.io`.
123+
124+
### Log In to the Administration
125+
126+
Open `https://APPNAME.hypernode.io/admin` in your browser and log in with the default credentials:
127+
128+
- Username: `admin`
129+
- Password: `shopware`
130+
131+
```{warning}
132+
Change the password of the admin user directly after your first login.
133+
```
134+
135+
**Done!** You've now successfully installed the latest version of Shopware 6.
136+
137+
For better performance, configure [Redis](./how-to-configure-redis-for-shopware-6.md) and [Varnish](./how-to-configure-varnish-for-shopware-6.md) for your shop.
138+
139+
## Install Shopware 6.0
140+
141+
The steps below explain how to install Shopware 6.0.
142+
143+
### Upgrade Your PHP Version
144+
145+
Shopware 6.0 needs at least PHP version 7.4 to be able to run. So the first thing to do is upgrade your PHP version to 7.4 with the following command:
21146

22147
```bash
23148
hypernode-systemctl settings php_version 7.4
24149
```
25150

26-
## Change the MySQL Version to 5.7
151+
### Change the MySQL Version to 5.7
27152

28-
Shopware 6 needs MySQL 5.7 to be able to run. You can change the MySQL version by running the following command:
153+
Shopware 6.0 needs MySQL 5.7 to be able to run. You can change the MySQL version by running the following command:
29154

30155
```bash
31156
hypernode-systemctl settings mysql_version 5.7
32157
```
33158

34-
## Install Node.js v10.16
159+
### Install Node.js v10.16
35160

36161
```bash
37162
hypernode-systemctl settings nodejs_version 10
38163
```
39164

40-
## Two Ways to Install Shopware 6
165+
### Two Ways to Install Shopware 6.0
41166

42-
There are two ways to install Shopware 6: either by using the pre-install or doing it manually. See below for the two options. *Please note: you only have to use one of the two options to install Shopware 6.*
167+
There are two ways to install Shopware 6.0: either by using the pre-install or doing it manually. See below for the two options. *Please note: you only have to use one of the two options to install Shopware 6.0.*
43168

44-
### Download and Install Shopware 6 Using the Pre-install
169+
#### Download and Install Shopware 6 Using the Pre-install
45170

46171
On Hypernode we offer an easy way to install Shopware 6 using one of our pre-install images. Use the following command to install Shopware 6.
47172

48173
```bash
49174
hypernode-systemctl preinstall shopware_6
50175
```
51176

52-
### Download and Install the Latest Version of Shopware 6
177+
#### Download and Install Shopware 6.0 Manually
53178

54-
Download the latest Shopware 6 version to the public folder from the [Shopware website](https://www.shopware.com/en/download/#shopware-6) by right clicking on "Download for free" click on "Copy Link Address" and paste the link after the `wget` command below.
179+
Download Shopware 6.0 to the public folder from the [Shopware website](https://www.shopware.com/en/download/#shopware-6) by right clicking on "Download for free" click on "Copy Link Address" and paste the link after the `wget` command below.
55180

56181
```bash
57182
mkdir shopware
@@ -67,7 +192,7 @@ rm -rf /data/web/public
67192
ln -s /data/web/shopware/public/ /data/web/public
68193
```
69194

70-
## Install Shopware 6
195+
### Run the Shopware 6.0 Installer
71196

72197
Now open your browser and browse to `https://APPNAME.hypernode.io/recovery/update/index.php`. At this point you can follow the guide through your browser. Make sure to fill in the right details at the **Configure database**:
73198

@@ -78,7 +203,7 @@ Now open your browser and browse to `https://APPNAME.hypernode.io/recovery/updat
78203
- Select "new database", and pick a name you like
79204
- Fill in the **Basic shop set-up** how you see fit.
80205

81-
**Done!** You’ve now successfully installed Shopware 6.
206+
**Done!** You’ve now successfully installed Shopware 6.0.
82207

83208
**Demo data**
84-
If you’d like you could install demo data as well. To do this you’ll need to login the backend: `http://APPNAME.hypernode.io/admin/` with the credentials you entered during the step: Basic shop set-up at the installation. At your first login you’ll see the “First Run Wizard”, make sure to install the Demo data at the “Demo data” menu.
209+
If you’d like you could install demo data as well. To do this you’ll need to login the backend: `https://APPNAME.hypernode.io/admin/` with the credentials you entered during the step: Basic shop set-up at the installation. At your first login you’ll see the “First Run Wizard”, make sure to install the Demo data at the “Demo data” menu.

0 commit comments

Comments
 (0)