---
title: "Installing J2Commerce"
description: "This guide covers installing J2Commerce on a fresh Joomla 6 installation."
url: "https://docs.j2commerce.com/v6/getting-started/installation"
markdown_url: "https://docs.j2commerce.com/v6/getting-started/installation.md"
last_updated: "2026-10-23T03:39:01+00:00"
version: "J2Commerce 6"
breadcrumbs:
  - title: "Home"
    url: "https://docs.j2commerce.com/"
  - title: "J2Commerce 6"
    url: "https://docs.j2commerce.com/v6"
  - title: "Getting Started"
    url: "https://docs.j2commerce.com/v6/getting-started"
  - title: "Installing J2Commerce"
    url: "https://docs.j2commerce.com/v6/getting-started/installation"
---

# Installing J2Commerce

This guide covers installing **J2Commerce** on a fresh **Joomla 6** installation.

## Requirements

### Server Requirements

| Requirement | Minimum | Recommended |
| --- | --- | --- |
| PHP | 8.3.0 | 8.3+ |
| MySQL | 8.0+ | 8.0+ |
| Joomla | 6.0+ | 6.0+ |

### PHP Extensions

- `mysqli` or `pdo_mysql`: Database connectivity
- `json`: JSON encoding/decoding
- `curl`: HTTP requests for payment gateways and currency updates
- `mbstring`: Multi-byte string support
- `gd` or `imagick`: Image processing
- `zip`: Extension installation
- `openssl`: Secure API connections

### Permissions

The following directories must be writable by the web server:

- `/tmp`: Temporary file storage
- `/logs`: Log file writes
- `/administrator/cache`: Cache files

## Purchase and Download

**Step 1:** Go to our [**J2Commerce** website](https://www.j2commerce.com/extensions) **-> Plugins**

**Step 2:** Locate the **J2Commerce installation package** **->** click **View Details** **->** **Add to cart** **->** **Checkout**.

**Step 3:** Go to your **My Downloads** under your profile button at the top right corner and search for the app. Click **Available Versions -> View Files -> Download**

### Install J2Commerce

You can install this **J2Commerce installation package** using the Joomla installer. The following steps help you with a successful installation.

In the Joomla admin, go to **System -> Install -> Extensions**

Upload the plugin ZIP file or use the Install from URL option.

![Install extensions](https://docs.j2commerce.com/images/docs/v4/assets/app%20install1%20%281%29%20%281%29.webp)

> **Tip:** If you're upgrading from J2Store, use the **Install from Directory** option and select the extracted folder. The installer detects the upgrade path automatically.

## Enable Required Plugins

After installation, J2Commerce requires several system plugins to be enabled:

Navigate to **System -> Manage -> Plugins**

![Joomla System Dashboard with System in the sidebar, the Manage section and its Plugins link highlighted](https://docs.j2commerce.com/images/docs/shared/user-plugin1.webp)

Search for `j2commerce`

![Joomla Plugins list searched for j2commerce, with the search box and the enabled Status check on Content - J2Commerce highlighted](https://docs.j2commerce.com/images/docs/shared/j2commerce-enable.webp)

Enable the following plugins:

- **System - J2Commerce**: Core system integration
- **System - J2Commerce Content**: Article-to-product conversion
- **Content - J2Commerce**: Product display in articles

### Verify Installation

Go to **Components -> J2Commerce**

You should see the **Dashboard**

![J2Commerce Dashboard with Components, J2Commerce and Dashboard highlighted, showing the Setup Wizard button, 30 Days filter and Store Stats cards](https://docs.j2commerce.com/images/docs/shared/getting-started-dashboard1.webp)

The **Setup Wizard** should appear if this is a fresh installation

![J2Commerce Dashboard with the purple Setup Wizard button highlighted in the toolbar above the J2Commerce navigation bar](https://docs.j2commerce.com/images/docs/shared/getting-started-wizard.webp)

## Manual Installation

If the Joomla installer fails, you can install manually:

### Via File Manager

1. Extract the J2Commerce `.zip` file
2. Upload the extracted contents to your Joomla installation via FTP or file manager:
   - Component to: `/administrator/components/com_j2commerce/`
   - Media to: `/media/com_j2commerce/`
   - Plugins to: `/plugins/system/j2commerce/`, `/plugins/content/j2commerce/`, etc.
3. Log in to phpMyAdmin and import the SQL file if provided
4. Enable plugins via **System -> Manage -> Plugins**

### Via Command Line

```bash
# Navigate to your Joomla installation
cd /var/www/html

# Extract the package
unzip j2commerce.zip

# Move files to correct locations
mv j2commerce/administrator/components/com_j2commerce administrator/components/
mv j2commerce/media/* media/com_j2commerce/
mv j2commerce/plugins/* plugins/

# Set permissions
chmod -R 755 administrator/components/com_j2commerce
chmod -R 755 media/com_j2commerce
```

## Post-Installation Checklist

After installation, verify the following:

- [ ] Dashboard loads without errors
- [ ] Setup Wizard appears (fresh install)
- [ ] The product menu is accessible
- [ ] The orders menu is accessible
- [ ] Settings save correctly
- [ ] Payment methods can be configured
- [ ] Shipping methods can be configured

## Troubleshooting

### Installation Fails

**Error: "Unable to find install package"**

- The zip file may be corrupted. Download again and retry.
- Ensure you're uploading the `.zip` file directly, not an extracted folder.

**Error: "Unable to copy files"**

- Check directory permissions. The web server user needs write access.
- Verify the `/tmp` and `/logs` directories exist and are writable.

### Blank Screen After Installation

1. Enable Joomla's debug mode: **System -> Global Configuration -> System -> Debug**
2. Check `/logs/error.php` for PHP errors
3. Verify PHP version and required extensions

### Plugin Not Found

If plugins don't appear in the plugin manager:

1. Verify all plugin folders were uploaded
2. Check for duplicate installations from J2Commerce
3. Clear Joomla cache: **Home Dashboard -> System -> Cache -> Delete Cache**

![Joomla Home Dashboard with Home Dashboard highlighted and the System panel's Cache tile outlined, used to clear the site cache](https://docs.j2commerce.com/images/docs/shared/getting-started-cache.webp)

## Uninstalling

To uninstall J2Commerce:

1. Go to **System -> Manage -> Extensions**
2. Find **J2Commerce** in the component list
3. Click **Uninstall**

![Joomla System Dashboard with System in the sidebar and the Manage section's Extensions link highlighted, used to uninstall J2Commerce](https://docs.j2commerce.com/images/docs/shared/getting-started-uninstall.webp)

> **Warning:** Uninstalling removes all J2Commerce data, including products, orders, and customers. Create a backup before proceeding.