PHPackages                             johncms/johncms - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database &amp; ORM](/categories/database)
4. /
5. johncms/johncms

ActiveLibrary[Database &amp; ORM](/categories/database)

johncms/johncms
===============

Content Management System

9.7.0(4mo ago)584628[1 issues](https://github.com/johncms/johncms/issues)GPL-3.0-onlyPHPPHP ^8.2CI passing

Since Sep 8Pushed 5d ago9 watchersCompare

[ Source](https://github.com/johncms/johncms)[ Packagist](https://packagist.org/packages/johncms/johncms)[ Docs](https://johncms.com)[ RSS](/packages/johncms-johncms/feed)WikiDiscussions 9.x Synced 6d ago

READMEChangelog (10)Dependencies (28)Versions (16)Used By (0)

[JohnCMS](https://johncms.com)
==============================

[](#johncms)

[![GitHub](https://camo.githubusercontent.com/80e6e1b64839634c3611b3079815c6d300aefa790c59f44ab0409635178f81d8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6a6f686e636d732f6a6f686e636d733f636f6c6f723d626c7565)](https://github.com/johncms/johncms/blob/develop/LICENSE)[![Source Code](https://camo.githubusercontent.com/46ea09b9b5fd69ea4a16f711c560a7bf3c7c874fa263dbeb873ddc96b719c571/687474703a2f2f696d672e736869656c64732e696f2f62616467652f736f757263652d6a6f686e636d732f6a6f686e636d732d626c75652e737667)](https://github.com/johncms/johncms)[![GitHub tag (latest SemVer)](https://camo.githubusercontent.com/293c5cc344bb05a434ae121886d0c5502c4e5cb97d0ef5a335a94d58088bc01b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7461672f6a6f686e636d732f6a6f686e636d732e7376673f6c6162656c3d737461626c65)](https://github.com/johncms/johncms/releases)

[![PHP-CI](https://github.com/johncms/johncms/workflows/PHP-CI/badge.svg?branch=9.x)](https://github.com/johncms/johncms/actions)[![Crowdin](https://camo.githubusercontent.com/4bcbb076ab93ed13ea01d383bd5f43c0287d9ab18682872be3b8e9f5c625e154/68747470733a2f2f6261646765732e63726f7764696e2e6e65742f6a6f686e636d732f6c6f63616c697a65642e737667)](https://crowdin.com/project/johncms)

JohnCMS is an open-source PHP community CMS. It includes a forum, news, library, downloads, private messages, photo albums, and more — all in one package.

Features
--------

[](#features)

- **Forum** — CKEditor-based editor with image upload, SEO-friendly URLs for sections and topics, polls, file attachments, topic pinning and closing
- **News** — unlimited nested sections, scheduled publishing, tags, comments, ratings
- **Library** — unlimited nested sections, user-submitted articles, moderation
- **Downloads** — file catalog with ratings and comments
- **Private messages** — with file attachments
- **Photo albums** — personal user albums
- **Guestbook** — site-wide and personal guestbooks
- **Notifications** — notification center with per-user settings
- **Dark theme** — built-in light/dark theme switch
- **Multilingual** — full i18n support via Crowdin
- **Sitemap** — automatic XML sitemap generation

Requirements
------------

[](#requirements)

- PHP **8.2** or higher
- MySQL **5.6.4** or higher (MySQL Native Driver `mysqlnd` required)
- Apache with `.htaccess` support
- PHP extensions: `imagick` or `gd`, `mbstring`, `pdo`, `simplexml`

Installation from distribution
------------------------------

[](#installation-from-distribution)

1. Download the latest release archive from the [releases page](https://github.com/johncms/johncms/releases).
2. Extract and upload the files to your server's web root.
3. Open `http://your.site/install` in a browser and follow the installer steps.
4. **Delete the `/install` directory** after installation is complete.

Installation from repository
----------------------------

[](#installation-from-repository)

1. Make sure you have [Composer](https://getcomposer.org/) and [Node.js](https://nodejs.org/) installed.
2. Install PHP dependencies: ```
    composer install
    ```
3. Install Node.js dependencies and build assets: ```
    npm install
    npm run prod
    ```
4. Open `http://your.site/install` in a browser and follow the installer steps.
5. **Delete the `/install` directory** after installation is complete.
6. Set up a cron job to run the scheduler every minute: ```
    * * * * * php /path/to/system/bin/console schedule:run --no-interaction

    ```

Installation with Docker
------------------------

[](#installation-with-docker)

1. Copy the environment file and adjust the values if needed: ```
    cp .env.example .env
    ```
2. Build and start the containers: ```
    make build
    make up
    ```
3. Install PHP dependencies: ```
    make composer-install
    ```
4. Open `http://your.site/install` in a browser and follow the installer steps.
5. **Delete the `/install` directory** after installation is complete.

The Docker setup includes Nginx, PHP-FPM, MariaDB, and [Ofelia](https://github.com/mcuadros/ofelia) for running the scheduler automatically every minute.

### Useful make commands

[](#useful-make-commands)

CommandDescription`make up`Start containers`make stop`Stop containers`make restart`Restart containers`make rebuild`Rebuild and restart containers`make shell`Open shell inside the PHP-FPM container`make composer-install`Run `composer install` inside the container`make composer-update`Run `composer update` inside the container`make backup-db`Dump the database to a SQL file`make restore-db`Restore the database from a SQL fileFor detailed Docker configuration instructions see [.docker/readme.md](.docker/readme.md).

Updating from repository
------------------------

[](#updating-from-repository)

- If `composer.json` changed — re-run `composer install`.
- If `package.json` changed — re-run `npm install && npm run prod`.
- If only `.scss`/`.js` files changed — re-run `npm run prod`.
- During development, use `npm run watch` to rebuild assets automatically on change.

Documentation
-------------

[](#documentation)

Full documentation is available at [docs.johncms.com](https://docs.johncms.com/).

Contributing &amp; Translations
-------------------------------

[](#contributing--translations)

Translations are managed on [Crowdin](https://crowdin.com/project/johncms). Feel free to contribute or report issues on [GitHub](https://github.com/johncms/johncms/issues).

###  Health Score

56

—

FairBetter than 98% of packages

Maintenance87

Actively maintained with recent releases

Popularity25

Limited adoption so far

Community24

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor1

Top contributor holds 50.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~187 days

Recently: every ~484 days

Total

14

Last Release

6d ago

Major Versions

7.1.0 → 8.0.02019-10-23

8.0.0 → 9.0.02020-02-09

PHP version history (7 changes)7.0.0-betaPHP ^5.5 || ^7.0

7.0.0PHP ^5.6 || ^7.0

8.0.0PHP ^7.1

9.0.0PHP ^7.2

9.4.0PHP ^7.3|^8.0

9.5.0PHP ^7.3 || ^8.0

9.7.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/f5eb677319842cc5aeadd52a94873f1635087faa55c8afa9dd2045b89267f4b5?d=identicon)[Simba77](/maintainers/Simba77)

---

Top Contributors

[![simba77](https://avatars.githubusercontent.com/u/17108240?v=4)](https://github.com/simba77 "simba77 (1343 commits)")[![batumibiz](https://avatars.githubusercontent.com/u/10770779?v=4)](https://github.com/batumibiz "batumibiz (1164 commits)")[![Compolomus](https://avatars.githubusercontent.com/u/10777258?v=4)](https://github.com/Compolomus "Compolomus (66 commits)")[![ua0sqq](https://avatars.githubusercontent.com/u/29824774?v=4)](https://github.com/ua0sqq "ua0sqq (29 commits)")[![JeskCMS](https://avatars.githubusercontent.com/u/20934783?v=4)](https://github.com/JeskCMS "JeskCMS (12 commits)")[![ging-dev](https://avatars.githubusercontent.com/u/42226341?v=4)](https://github.com/ging-dev "ging-dev (12 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (10 commits)")[![aNNiMON](https://avatars.githubusercontent.com/u/1321838?v=4)](https://github.com/aNNiMON "aNNiMON (7 commits)")[![krchVova](https://avatars.githubusercontent.com/u/9292020?v=4)](https://github.com/krchVova "krchVova (2 commits)")[![vladgba](https://avatars.githubusercontent.com/u/11693645?v=4)](https://github.com/vladgba "vladgba (1 commits)")[![Mi7teR](https://avatars.githubusercontent.com/u/5999356?v=4)](https://github.com/Mi7teR "Mi7teR (1 commits)")[![AlphaHot](https://avatars.githubusercontent.com/u/58410019?v=4)](https://github.com/AlphaHot "AlphaHot (1 commits)")

---

Tags

cmsjohncmsmobilemysqlphpphpmysqlmobilecmsjohncms

###  Code Quality

Static AnalysisPsalm

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/johncms-johncms/health.svg)

```
[![Health](https://phpackages.com/badges/johncms-johncms/health.svg)](https://phpackages.com/packages/johncms-johncms)
```

###  Alternatives

[magento/community-edition

Magento 2 (Open Source)

12.1k52.1k10](/packages/magento-community-edition)[wheelpros/fitment-platform-api

Magento 2 (Open Source)

12.1k1.2k](/packages/wheelpros-fitment-platform-api)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[getgrav/grav

Modern, Crazy Fast, Ridiculously Easy and Amazingly Powerful Flat-File CMS

15.4k84.1k1](/packages/getgrav-grav)[flarum/core

Delightfully simple forum software.

211.3M1.9k](/packages/flarum-core)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
