2
Installation
Jonathan Miller edited this page 2026-05-10 00:08:25 +00:00

← Back to Home

Installation

Requirements

Requirement Minimum Version
Joomla 5.x or 6.x
PHP 8.1 or higher

Download

Download the latest mokoonyx-{version}.zip from the Releases page.

Install via Joomla Admin

  1. Log in to your Joomla administrator panel
  2. Navigate to System → Install → Extensions
  3. Upload the mokoonyx-{version}.zip file
  4. Wait for the installer to complete

The installer performs a preflight check to verify your PHP and Joomla versions meet the minimum requirements. If they do not, installation will be blocked with an error message.

Set as Default Template

  1. Navigate to System → Site Templates
  2. Click the star icon next to MokoOnyx to set it as the default site template

First Page Load (Migration)

If you are migrating from MokoCassiopeia, the migration runs automatically during install:

  1. Visit any page on your site after installation -- the template activates immediately
  2. Check administrator/logs/mokoonyx.log.php to confirm the migration completed
  3. Once confirmed, uninstall MokoCassiopeia from Extensions → Manage

See the Migration page for full details on what gets migrated.

Post-Install Notes

  • The extension is automatically locked after install to prevent accidental uninstallation
  • Stale .min files from previous versions are cleaned automatically
  • Favicon stamps are cleared so favicons regenerate on the next page load
  • MokoCassiopeia references in article content and modules are automatically updated to MokoOnyx

Update Server

MokoOnyx includes an automatic update server. Joomla will notify you when new versions are available via System → Update → Extensions. Two update servers are configured for redundancy:

Priority Server
1 Gitea (git.mokoconsulting.tech)
2 GitHub (github.com)

Built with MokoStandards -- Moko Consulting


Repo: MokoOnyx · MokoStandards

Revision Date Author Description
1.0 2026-05-09 Moko Consulting Initial version