docs.rkonik.com
1.0
1.0
EN
PL EN

Technical requirements

Environment requirements for installing and operating LENA.

Supported environment

LENA 1.0 requires:

  • Joomla 5.x or 6.x;
  • PHP 8.1 or later, subject to the requirements of the Joomla version in use;
  • a MySQL or MariaDB version supported by Joomla;
  • the PHP fileinfo, gd and mbstring extensions.

The server must allow PHP to write files inside Joomla’s images directory and read originals while generating thumbnails.

Reading the date taken and automatically correcting JPEG orientation also requires the PHP exif_read_data function from the exif extension. Its absence does not block uploads, but LENA will not read this information from the file.

Image processing

The PHP GD extension is required whenever a photo is uploaded. LENA retains the original and creates three image variants for lists, galleries and the enlarged viewer. If GD is unavailable or cannot process the uploaded format, the photo will not be added.

Supported input formats are:

  • JPEG (.jpg, .jpeg),
  • PNG (.png),
  • GIF (.gif),
  • WebP (.webp),
  • AVIF (.avif).

The presence of GD alone does not guarantee WebP or AVIF support. This depends on how PHP was built on the server. If in doubt, test one file first.

Upload limits

By default, LENA applies the single-file size limit configured in Joomla Media options. An administrator can instead set a separate LENA limit or enter 0 to disable the application-level limit. PHP and server restrictions still apply, particularly upload_max_filesize, post_max_size, available memory and the maximum execution time.

LENA does not define its own width, height or total-pixel limit. A diagnostic table in the component options displays restrictions detected in the environment; it does not change the server configuration.

Images with very large pixel dimensions can consume substantial memory while variants are created, even if the compressed file itself is within the upload-size limit.

Browser

A current browser with JavaScript enabled is required for full administrator-area and gallery operation. Drag and drop, viewers, bulk actions and automatic ordering updates depend on JavaScript.

Pre-installation checklist

Before installing, check:

  1. the Joomla and PHP versions;
  2. availability of fileinfo, gd and mbstring;
  3. write access to the images directory;
  4. PHP upload and memory limits;
  5. a current backup of the Joomla files and database.