Clone
2
Installation
Jonathan Miller edited this page 2026-05-10 00:08:25 +00:00
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
- Log in to your Joomla administrator panel
- Navigate to System → Install → Extensions
- Upload the
mokoonyx-{version}.zipfile - 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
- Navigate to System → Site Templates
- 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:
- Visit any page on your site after installation -- the template activates immediately
- Check administrator/logs/mokoonyx.log.php to confirm the migration completed
- 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
.minfiles 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 |