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.

    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

    No

    No

    No

    No

    No

    No

    No

    4.06 to 4.06.15

    Yes

    Yes

    Yes

    No

    No

    No

    No

    No

    4.06.16

    Yes

    Yes

    Yes

    Yes

    No

    No

    No

    No

    4.06.17+

    Yes

    Yes

    Yes

    Yes

    Yes

    No

    No

    No

    5.0.*

    No

    No

    No

    Yes

    Yes

    No

    No

    No

    5.1.*

    No

    No

    No

    Yes

    Yes

    Yes

    No

    No

    5.2.0

    No

    No

    No

    No

    No

    No

    Yes

    No

    5.2.3+

    No

    No

    No

    No

    No

    No

    Yes

    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

    1. Create a customer account in the JTL-Customer Centre: Go to JTL-Customer Centre.
    2. Go to Produkte > Onlineshop > Shop Editionen (Products > Online shop > Shop editions). You are now in the licence administration of JTL-Shop.
    3. 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.

    1. Click the button Aktionen (Actions) and select Downloads. The Download section opens. Click Download. The download package will now be downloaded.
    1. Read “Installation/Upgrade” next to learn about the next steps.

    Video

    Installing JTL-Shop

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