You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 0f85bf8
Browse filesBrowse the repository at this point in the historyBrowse files
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>
| 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:
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:
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:
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:
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:
21
146
22
147
```bash
23
148
hypernode-systemctl settings php_version 7.4
24
149
```
25
150
26
-
## Change the MySQL Version to 5.7
151
+
###Change the MySQL Version to 5.7
27
152
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:
29
154
30
155
```bash
31
156
hypernode-systemctl settings mysql_version 5.7
32
157
```
33
158
34
-
## Install Node.js v10.16
159
+
###Install Node.js v10.16
35
160
36
161
```bash
37
162
hypernode-systemctl settings nodejs_version 10
38
163
```
39
164
40
-
## Two Ways to Install Shopware 6
165
+
###Two Ways to Install Shopware 6.0
41
166
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.*
43
168
44
-
### Download and Install Shopware 6 Using the Pre-install
169
+
####Download and Install Shopware 6 Using the Pre-install
45
170
46
171
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.
47
172
48
173
```bash
49
174
hypernode-systemctl preinstall shopware_6
50
175
```
51
176
52
-
### Download and Install the Latest Version of Shopware 6
177
+
####Download and Install Shopware 6.0 Manually
53
178
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.
55
180
56
181
```bash
57
182
mkdir shopware
@@ -67,7 +192,7 @@ rm -rf /data/web/public
67
192
ln -s /data/web/shopware/public/ /data/web/public
68
193
```
69
194
70
-
##Install Shopware 6
195
+
### Run the Shopware 6.0 Installer
71
196
72
197
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**:
73
198
@@ -78,7 +203,7 @@ Now open your browser and browse to `https://APPNAME.hypernode.io/recovery/updat
78
203
- Select "new database", and pick a name you like
79
204
- Fill in the **Basic shop set-up** how you see fit.
80
205
81
-
**Done!** You’ve now successfully installed Shopware 6.
206
+
**Done!** You’ve now successfully installed Shopware 6.0.
82
207
83
208
**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