> For the complete documentation index, see [llms.txt](https://harmonycms.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://harmonycms.gitbook.io/docs/getting-started/installation.md).

# 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](/docs/reference/requirements.md) and have [Composer](https://getcomposer.org) installed. If you don't, start by [*installing Composer globally*](https://symfony.com/doc/current/setup/composer.html) on your system.

Now, create your new HarmonyCMS project by running:

```php
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!

{% hint style="info" %}
Installation may sometimes fail, see troubleshooting for the [Memory limit error](https://docs.harmonycms.net/reference/troubleshooting#memory-limit-errors)
{% endhint %}

## 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](http://www.doctrine-project.org/).

### 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:

```bash
composer require emulienfou/orm-pack
```

{% hint style="info" %}
Full documentation available in the [Databases and the Doctrine ORM](https://symfony.com/doc/current/doctrine.html) Symfony page.\
The full list of supported platform by Doctrine DBAL are listed [here](https://www.doctrine-project.org/projects/doctrine-dbal/en/2.9/reference/platforms.html).
{% endhint %}

{% hint style="warning" %}
This pack also provide 2 virtual packages who can be used to require a doctrine database support:

* `doctrine/implementation`
* `doctrine/orm-implementation`
  {% endhint %}

### No-SQL

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

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

{% hint style="info" %}
Full documentation available in the [DoctrineMongoDBBundle](https://symfony.com/doc/current/bundles/DoctrineMongoDBBundle/index.html) Symfony page.
{% endhint %}

{% hint style="warning" %}
This pack also provide 2 virtual packages who can be used to require a doctrine database support:

* `doctrine/implementation`
* `doctrine/mongodb-implementation`
  {% endhint %}