Install Joomla Fediverse

Overview

Install Joomla Fediverse so your Joomla site can be followed in the Fediverse and publish outward from its own domain. This turns a normal Joomla site into a federated publishing server without requiring a separate social platform.

You need this procedure because the rest of the manual assumes the package is already present in Joomla. Without the package installation step, there is no dashboard, no actor management, and no Fediverse scheduler task support to configure. After you complete it, Joomla Fediverse appears in the administrator interface and you can continue with the normal setup sequence.

Before you begin

You need administrator access to the Joomla backend.
The server must meet the package requirements:
- Joomla 6.0 or later
- PHP 8.3 or later
- PHP extension openssl
Download the current package archive, for example pkg_fediverse-x.y.z.zip.
Keep the package as a .zip file. Joomla installs the package archive directly; you do not need to unpack it first.

Steps

Sign in to the Joomla administrator backend.
Open System -> Install -> Extensions.
Upload the Fediverse package archive.
- Package file - Select the downloaded pkg_fediverse-x.y.z.zip archive. This is the installable Joomla package that contains the component, plugins, and modules required by Joomla Fediverse.
Wait for Joomla to finish the package installation.
Open Components -> Fediverse.
Confirm the Fediverse dashboard loads.
Continue with the first-time setup tasks from the user manual:
- activate the core Fediverse plugins
- configure component options
- configure scheduled tasks
- run the diagnostics wizard

Check your result

Joomla shows a successful installation message for the package.
Components -> Fediverse is available in the administrator menu.
The Fediverse dashboard opens without an extension-not-found error.
The optional Fediverse modules are present in Joomla’s extension list.

Troubleshooting

The package upload is rejected

Likely cause: The uploaded file is not the package archive, the archive is damaged, or the server blocks the upload.
Solution: Download a fresh pkg_fediverse-x.y.z.zip file, make sure you upload the .zip package itself, and retry the installation. If Joomla still rejects the upload, check the server’s upload limits and PHP error logs.

The package installs, but `Components -> Fediverse` is missing

Likely cause: The package installation did not complete correctly, or Joomla’s extension list is stale.
Solution: Open System -> Manage -> Extensions, search for fediverse, and confirm the component and related extensions exist. If they do not, reinstall the package.

The dashboard opens, but setup cannot continue

Likely cause: The package is installed, but the required plugins are still disabled.
Solution: Continue with Activate Core Fediverse Plugins before trying to create actors or publish content.