Files
MokoOnyx/wiki/guides/installation.md
T
jmiller 82e04b1818
Universal: PR Check / Branch Policy (pull_request) Successful in 2s
Universal: PR Check / Require Docs Update (pull_request) Has been skipped
Universal: PR Check / Wiki Update Reminder (pull_request) Has been skipped
Universal: PR Check / Secret Scan (pull_request) Successful in 6s
Generic: Project CI / Tests (pull_request) Failing after 9s
Generic: Project CI / Lint & Validate (pull_request) Successful in 12s
Universal: Pre-Release / Build Pre-Release (${{ inputs.stability || github.ref_name }}) (push) Successful in 14s
Joomla: Metadata Validation / Validate Joomla Metadata (pull_request) Failing after 9s
Universal: PR Check / Validate PR (pull_request) Failing after 15s
Universal: PR Check / Build RC Package (pull_request) Has been cancelled
Universal: PR Check / Report Issues (pull_request) Has been cancelled
chore: sync main into dev (resolve infra/doc divergence)
# Conflicts:
#	.mokogitea/workflows/issue-branch.yml
#	CHANGELOG.md
#	SECURITY.md
#	source/html/layouts/joomla/module/card.php
#	source/html/layouts/mokoonyx/article-metadata.php
#	source/media/css/a11y-high-contrast.css
#	source/templateDetails.xml
2026-07-12 19:22:08 -05:00

2.4 KiB

← 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 moko-platform -- Moko Consulting


Repo: MokoOnyx · moko-platform

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