Skip to main content

Installation and Upgrade

Overview

This document describes the procedures for installing, updating, and upgrading a Joomla component using the Joomla Administrator interface. It applies to Joomla versions that support the Extensions Manager and Update Server mechanism.

System Requirements

Before installing or upgrading the component, ensure the following:

  • A supported Joomla version is installed (as specified by the component vendor).

  • Administrator access to the Joomla backend.

  • PHP, database, and server requirements meet Joomla and component requirements.

  • A full site and database backup has been completed.

Component Installation

Method 1: Install from Package File (Recommended)

  1. Log in to the Joomla Administrator panel.

  2. Navigate to System → Install → Extensions.

  3. Under the Upload Package File tab:

    • Click Browse and select the component installation package (.zip file).

    • Click Upload & Install.

  4. Wait for the installation process to complete.

  5. Confirm the success message indicating the component was installed successfully.

Method 2: Install from URL (Optional)

  1. Log in to the Joomla Administrator panel.

  2. Navigate to System → Install → Extensions.

  3. Select the Install from URL tab.

  4. Enter the direct URL to the component installation package.

  5. Click Install.

  6. Verify the installation success message.

Post-Installation Steps

After installation:

  1. Navigate to Components → [Component Name].

  2. Review and configure global component options as required.

  3. Assign user permissions under System → Global Configuration → Permissions (if applicable).

  4. Publish any related modules or plugins provided with the component.

Component Upgrade Using Joomla Update Server

The component supports upgrades via the Joomla Update Server, allowing administrators to receive and apply updates directly from the backend.

Configuring the Update Server

  1. Log in to the Joomla Administrator panel.

  2. Navigate to System → Update → Extensions.

  3. Click Update Sites.

  4. Locate the update site for the component:

    • Ensure the update site is Enabled.

    • If missing, reinstall the component or manually add the update site as provided by the vendor.

  5. Click Rebuild to refresh the update sites list.

Performing the Upgrade

  1. Navigate to System → Update → Extensions.

  2. Click Check for Updates.

  3. When an update for the component appears:

    • Select the checkbox next to the component.

    • Click Update.

  4. Wait for the upgrade process to complete.

  5. Confirm the success message.

Post-Upgrade Verification

After upgrading:

  1. Navigate to Components → [Component Name].

  2. Verify the component version number.

  3. Review configuration settings to ensure they were retained.

  4. Test key component functionality.

  5. Clear Joomla and browser caches if necessary.

Troubleshooting

  • Update not appearing:
    Rebuild update sites and clear Joomla cache.

  • Installation or upgrade fails:
    Review Joomla error messages and server error logs.

  • Missing update site:
    Reinstall the component or manually add the update site URL.

Uninstallation (Optional)

  1. Navigate to System → Manage → Extensions.

  2. Search for the component.

  3. Select the component and click Uninstall.

  4. Confirm removal.

Back to top