Joomla! CMS™

Build Status

Actions	PHP	Node	npm

Overview

• This is the source of Joomla! 5.x.
• Joomla's Official website.
• Joomla! 5.4 version history.
• Detailed changes are in the changelog.

What is Joomla?

• Joomla! is a Content Management System (CMS) which enables you to build websites and powerful online applications.
• It is a simple and powerful web server application which requires a server with PHP and either MySQL, MariaDB or PostgreSQL to run. You can find full technical requirements here.
• Joomla! is free and Open Source software distributed under the GNU General Public License version 2 or later.

Looking for an installable package?

Joomla is not installable out of the box from this repository, please use:

• For the latest stable package: https://downloads.joomla.org
• For a nightly package: https://developer.joomla.org/nightly-builds.html

How to get a working installation from the source

For detailed instructions please visit https://docs.joomla.org/Special:MyLanguage/J5.x:Setting_Up_Your_Local_Environment

You will need:

• PHP - basically the same as you need for running a Joomla Site, but you need the cli (command line interface) Version (see https://docs.joomla.org/Special:MyLanguage/Configuring_a_LAMPP_server_for_PHP_development)
• Composer - for managing Joomla's PHP Dependencies. For help installing composer please read the documentation at https://getcomposer.org/doc/00-intro.md
• Node.js - for compiling Joomla's Javascript and SASS files. For help installing Node.js please follow the instructions available on https://nodejs.org/en/
• Git - for version management. Download from here https://git-scm.com/downloads (MacOS users can also use Brew and Linux users can use the built-in package manager, eg apt, yum, etc).

Steps to setup the local environment:

• Clone the repository:

git clone https://github.com/joomla/joomla-cms.git

• Go to the joomla-cms folder:

cd joomla-cms

• Go to the 5.4-dev branch:

git checkout 5.4-dev

• Install all the needed composer packages:

composer install

• Install all the needed npm packages:

npm ci

Things to be aware of when pulling: Joomla creates a cache of the namespaces of its extensions in JOOMLA_ROOT/administrator/cache/autoload_psr4.php. If extensions are created, deleted or removed in git then this file needs to be recreated. You can simply delete the file and it will be regenerated on the next call to Joomla.

Do you want to improve Joomla?

• Where to request a feature?
• How do you report a bug on the Issue Tracker?
• How to submit code to the Joomla CMS using a Pull Request?
• Get Involved: Joomla! is community developed software. Join the community.
• Documentation for Developers.
• Documentation for Web designers.
• Provide a translation for Joomla: Joomla Crowdin Project

Which branch should my Pull Request target?

Using a simple classification keeps the project stable, transparent, and easy for everyone to contribute.

Type of change	What it means	Target branch
Bug / Patch release	The change fixes an actual error. The software crashes, produces the wrong result, or behaves contrary to its specification. It can be resolved without large‑scale refactoring or new functionality.	5.4-dev (6.1-dev) *
Feature / Minor release	Anything that isn’t a strict bug – new behavior, refactoring, performance improvements, enhancements, UI tweaks, etc. These changes are bundled together for the next minor version.	6.2-dev

* All bugs that already exist in version 5.4.x should be fixed in 5.4-dev. Only bugs that are introduced for the first time in version 6.x should target the 6.1-dev branch.

A member of the maintainer or bug squad team confirms the classification and sets the appropriate labels when a PR is opened. If a PR is opened in the wrong branch, a maintainer will simply ask you to retarget it to the proper branch.

Copyright

• (C) 2005 Open Source Matters, Inc. https://www.joomla.org
• Distributed under the GNU General Public License version 2 or later
• See License details