Quick search:eBay DataTransfer JTL-Worker PayPal

JTL-Links

Thank you for using the English version of the JTL-Guide!
We are currently still building up the English documentation; not all sections have been translated yet. Please note that there may still be German screenshots or links to German pages even on pages that have already been translated. This guide mostly addresses English speaking users in Germany.

Note: On 1 September 2024, JTL introduced new editions that bundle most of the previous individual services into different packages. In order for you to continue working as smoothly as possible, existing customers were automatically switched to the package configuration that best matched their existing contract. The individual packages differ in terms of limitations and/or range of functions. Therefore, some of the features described in the JTL-Guide may not be available to you as part of your booked JTL edition. You can change your package configuration in your JTL customer account. Find out more about the new editions and packages here. Check our FAQ for frequently asked questions about the product editions.

Contents

Video

Installing JTL-Shop

In this video we explain how to install JTL-Shop.

Downloading the Community Free Edition of JTL-Shop

Your task/initial situation

You have an online business with fewer than 500 items (including child items). You would like to use the free-of-charge Community Free Edition of JTL-Shop as a shop system.

Requirements/Restrictions

You do not have more than 500 different items which you want to upload to your shop (Checking the number of items).
Your server meets all the system requirements of JTL-Shop.

JTL-Shop system requirements

Please note: The system requirements represent the officially approved, recommended and supported setup for the operation of JTL-Shop. Operation with a similar setup (Windows, FreeBSD, sunOS, nginx web server, PHP FPM) is generally possible, but we cannot offer support for these setups and/or any resulting problems with the software. Alternative HTTP servers (e.g. NGINX): Please note that the .htaccess rules (e.g. for directory protection!) must be manually added to these servers via the corresponding rules.

Please make sure that your web server meets the following system requirements:

JTL-Wawi: At least version 1.0, for full UTF-8 support at least JTL-Wawi 1.6

Note: JTL-Wawi 1.6 or higher requires at least JTL-Shop version 4.06.

Operating system: Linux (Debian, Ubuntu etc.). Please note the information listed above.
64-bit Apache web server (PHP mode: FCGI or Apache Module) 2.2 or 2.4 with mod_rewrite module, .htaccess support. (The web server must allow for default rules to be overwritten and added.)
Database: MySQL 5 version 5.7 or later or MariaDB version 10.1 up to and including 10.9.6; as of JTL-Shop 5.2.3 even up to and including 10.11 (LTS); as of JTL-Shop 5.1 also MySQL 8.0
PHP version: JTL-Shop 5 requires at least PHP 8.1 from version 5.2. However, we recommend using PHP 8.2 from 5.2.3.

Which PHP version does JTL-Shop support?

Shop version

PHP 7.0

PHP 7.1

PHP 7.2

PHP 7.3

PHP 7.4

PHP 8

PHP 8.1

PHP 8.2

4.00 to 4.05

Yes

4.06 to 4.06.15

Yes

4.06.16

Yes

4.06.17+

Yes

5.0.*

Yes

5.1.*

Yes

5.2.0

Yes

5.2.3+

Yes

Mail server: Accessible locally or via SMTP
PHP modules:
SimpleXML
Imagick
Curl
Iconv
MBString
Tokenizer
Intl
PDO (MySQL)
IonCube Loaders (http://www.ioncube.com/loaders.php): JTL-Shop 5 is delivered with open source code and is ready for operation without IonCube Loader. However, IonCube Loader may be required for the operation of third-party plug-ins.
PHP settings:
PHP script execution time (max_execution_time) of at least 120 seconds
PHP memory limit (memory_limit) of at least 128 MB
Maximum PHP transfer size (FILE / upload_max_filesize) of at least 6 MB
Maximum PHP transfer size (POST / post_max_filesize) of at least 8 MB
allow_url_fopen enabled

Required webspace

How much web space is needed for how many items can only be determined theoretically by calculation. The decisive factors are not the items themselves, but mainly their images. Item images are stored in their original size on the webspace and additionally scaled in four different sizes for each shop language.

Thus, depending on the target image sizes and quality, one shop language results in a webspace 2-3 times larger than the original image file sizes.

One shop language
Average original size of 200 KB
Think about the image sizes you want to make available to customers. If you want to provide full HD images, you should not save 4k images that require a lot of storage space.
Item images that are stored in items in JTL-Wawi
Make sure that the images are well compressed (permissible file formats for item images are .jpg/.jpeg and .png).
In JTL-Shop, a setting specifies that the largest display option for item images matches that of JTL-Wawi.

Under these conditions, 10 GB of web space would be enough for about 17,000 to 25,000 item images.

Note on the online shop domain: We strongly advise against using a domain with umlauts/special characters for your online shop. These have often led to problems in the past. Unfortunately, error-free operation cannot be guaranteed. Instead, we recommend using a domain without umlauts/special characters as the main domain and only using the other domains as alias domains that forward to the main domain.

Web-hosting-specific requirements:

In our experience, problems with servers running sunOS and the IonCube loader are likely! Before installing the shop, please enquire with your hosting provider which operating system is used on the server. We recommend using Linux web servers.

Information for Hosting customers of 1&1: Hosting customers of 1&1 need to carry out some additional steps after installing JTL-Shop to enable ionCube. Please see Running JTL-Shop on a 1&1 or Strato server for more information.

Information for Strato Managed Virtual Server customers: When installing JTL-Shop/IonCube, “PHP mode and accelerator” must be set to CGI. To use the SEO module, the mode must then be set to “Fast CGI + APC” again.

Downloading JTL-Shop CFE

Create a customer account in the JTL-Customer Centre: Go to JTL-Customer Centre.
Go to Produkte > Onlineshop > Shop Editionen (Products > Online shop > Shop editions). You are now in the licence administration of JTL-Shop.
Click Community Free Lizenz erstellen (Generate Community Free licence). A new licence for the Community Free Edition of JTL-Shop will be generated.

You can then find the licence under Ungruppierte Lizenzen (Ungrouped licences). You will also receive an email.

Click the button Aktionen (Actions) and select Downloads. The Download section opens. Click Download. The download package will now be downloaded.

Read “Installation/Upgrade” next to learn about the next steps.

Go to “Initial installation of JTL-Shop”

Video

Installing JTL-Shop

In this video we explain how to install JTL-Shop.