This version is at an early stage of development. Many things may not work or work not as intended.

• PHP 8.1 and higher
• MySQL 5.7
• PHP configured to use MySQL Native Driver (mysqlnd)
• .htaccess support or any server configured to forward requests to /public/index.php

To install the general availability version, go to the project website and download the latest available distributive. Then follow the installation instructions that came with it.

To install the developer version, you must have a Composer dependency manager, NodeJS and GIT version control system.

1. Clone or download this repository on local workstation.
2. Assign the repository folder as Apache virtual host, or move contents to the previously created virtual host folder.
3. Create MySQL Database.
4. Open the console in the virtual host folder and install the dependencies using the command

npm install && composer install && npm run build

5. Open the url in your browser (replace your.site to your virtualhost name): http://your.site/install and follow the instructions in the installer.
6. This is all done. If you go to the address of your virtual host from the browser, you should see a working site with demo data.

To install the developer version, you must have a Docker and GIT version control system.

1. Clone or download this repository on local workstation.

git clone https://github.com/johncms/johncms.git johncms
cd johncms

2. Start the container

docker-compose up -d

3. Open the container console.

docker exec -it $(docker ps -q -f name=ubuntu) bash

4. Build assets and install dependencies

npm install && composer install && npm run build

5. Install the system in your browser using the following data

   Open the address http://localhost:8000

   DB Host: mariadb

   DB Name: johncms

   DB User: johncms

   DB Password: password

When you get updates from the repository, you need to follow the changes of some files.

• If composer.json has been changed, you need to run the command composer install.
• After updating or after changing routes, run the command php johncms cache:clear.

Also, after performing the update, you can run the following command:

make cms-update