Installation

This article describes how to install HarmonyCMS in your system.

1. Initiating a new HarmonyCMS project

To create your new HarmonyCMS project, first make sure to fulfill the requirements and have Composer installed. If you don't, start by installing Composer globally on your system.

Now, create your new HarmonyCMS project by running:

composer create-project harmony/skeleton my-project

This will create a new my-project directory, download all needed dependencies into it and generate the basic HarmonyCMS structure directories and files you'll need to have a complete functional project. In other words, your new new website will be ready!

Installation may sometimes fail, see troubleshooting for the Memory limit error

2. Database installation

HarmonyCMS is currently supporting SQL and No-SQL databases. To do that, this CMS is fully decoupled from any database system. This means, you will have to choose between SQL and No-SQL.

Such has Symfony, HarmonyCMS doesn't provide a component to work with the database, but it does provide tight integration with a third-party library called Doctrine.

SQL

You will need to install the emulienfou/orm-pack if your database server is one of MySQL, MariaDB, Oracle, Microsoft SQL Server, PostgreSQL, SAP Sybase SQL Anywhere, SQLite or Drizzle by executing the next command:

composer require emulienfou/orm-pack

Full documentation available in the Databases and the Doctrine ORM Symfony page. The full list of supported platform by Doctrine DBAL are listed here.

This pack also provide 2 virtual packages who can be used to require a doctrine database support:

  • doctrine/implementation

  • doctrine/orm-implementation

No-SQL

If your database server is MongoDB, you should install the next pack by executing the both commands:

composer config "platform.ext-mongo" "1.6.16"
composer require emulienfou/mongodb-pack

Full documentation available in the DoctrineMongoDBBundle Symfony page.

This pack also provide 2 virtual packages who can be used to require a doctrine database support:

  • doctrine/implementation

  • doctrine/mongodb-implementation

Last updated