# Requirements and installation

## System requirements

<table class="table" id="bkmrk-joomla-6.0-or-newer-"> <tbody> <tr> <th scope="row">Joomla</th> <td>6.0 or newer</td> </tr> <tr> <th scope="row">PHP</th> <td>8.3 or newer</td> </tr> <tr> <th scope="row">Database</th> <td>MySQL 8.0.13+ or MariaDB 10.4+</td> </tr> </tbody></table>

A backward compatibility plugin (`plg_behaviour_compat`) is **not**required. Media Organizer runs exclusively on the current Joomla 6 interfaces.

<div class="callout info" id="bkmrk-for-the-optional-ima">For the **optional** image optimisation through external encoders (pngquant, oxipng, jpegoptim, gifsicle, cwebp, avifenc) those programs have to be available on the server. Without them everything else works unchanged — the optimisation report then uses the built-in means only.

</div>## Installation

Media Organizer ships as a single package:

1. Open **System → Install → Extensions**.
2. Upload the file `pkg_jimgo-<version>.zip`.
3. The installation runs through without further questions.

The package contains:

<table class="table" id="bkmrk-part-purpose-after-t"> <thead> <tr> <th scope="col">Part</th> <th scope="col">Purpose</th> <th scope="col">After the installation</th> </tr> </thead> <tbody> <tr> <td>Component `com_jimgo`</td> <td>The application itself in the backend</td> <td>active</td> </tr> <tr> <td>Console plugin</td> <td>Provides the `jimgo:` commands</td> <td>enabled automatically</td> </tr> <tr> <td>Task plugin</td> <td>Scheduled scans through the Joomla task scheduler</td> <td>enabled automatically</td> </tr> <tr> <td>System plugin (404 monitoring)</td> <td>Records accesses to files in quarantine</td> <td>**disabled** — deliberately your decision</td> </tr> <tr> <td>Extension profiles</td> <td>Vetted knowledge about third-party extensions</td> <td>installed</td> </tr> </tbody></table>

<figure id="bkmrk-this-panel-greets-yo"> ![The panel after installing Media Organizer, with version, status and the cards Getting started, Enable updates and Help](https://docs.graup-it.de/uploads/images/gallery/2026-08/87kdoku-12-installationspanel.png) <figcaption>This panel greets you after the installation. It names the installed version and leads to the three things now due: the first scan, the download key for updates, and the manual. After an update, the changelog takes the place of "Getting started".</figcaption></figure>## Enabling the 404 monitoring

The 404 monitoring is switched off by default because it runs along with every page view. It is useful but not mandatory: it logs accesses to files you have already moved to quarantine. If a hit turns up there, the file was in use somewhere after all — a very strong reason *not* to delete it for good.

To switch it on: **System → Plugins** → search for *Media Organizer* → enable the system plugin.

## After the installation

You find Media Organizer under **Components → Media Organizer**. Nothing has been scanned and nothing changed yet — the extension is waiting for your first scan.

Before you start, a look at **Options** is worthwhile: there you define which areas are searched and which folders stay untouched in principle. The defaults are deliberately cautious and suitable for most websites.

<div class="callout warning" id="bkmrk-recommendation%3A-make">**Recommendation:** make a backup before the first cleanup — as you would before any major change to a live website. Media Organizer works reversibly, but a backup is no substitute for trust and trust is no substitute for a backup.

</div>## Where to go from here

- [Download key and updates](https://docs.graup-it.de/books/media-organizer-en/page/download-key-and-updates) — so that you receive updates
- [Quick start: the first scan](https://docs.graup-it.de/books/media-organizer-en/page/quick-start-the-first-scan)

<small>Applies to version 1.2.0.</small>

[Deutsche Fassung](https://docs.graup-it.de/link/60)