kanboard_ynh/sources/doc/postgresql-configuration.markdown

Postgresql configuration
========================

By default, Kanboard use Sqlite to store its data but it's also possible to use Postgresql.

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

- A Postgresql server already installed and configured
- The PHP extension `pdo_pgsql` installed (Debian/Ubuntu: `apt-get install php5-pgsql`)

Note: Kanboard is tested with **Postgresql 9.3 and 9.4**

Configuration
-------------

### Create an empty database with the command `pgsql`:

```sql
CREATE DATABASE kanboard;
```

### Create a config file

The file `config.php` should contains those values:

```php
<?php

// We choose to use Postgresql instead of Sqlite
define('DB_DRIVER', 'postgres');

// Mysql parameters
define('DB_USERNAME', 'REPLACE_ME');
define('DB_PASSWORD', 'REPLACE_ME');
define('DB_HOSTNAME', 'REPLACE_ME');
define('DB_NAME', 'kanboard');
```

Note: You can also rename the template file `config.default.php` to `config.php`.

### Importing SQL dump (alternative method)

The first time, Kanboard will run one by one each database migration and this process can take some time according to your configuration.

To avoid any issues or potential timeouts you can initialize the database directly by importing the SQL schema:

```bash
psql -U postgres my_database < app/Schema/Sql/postgres.sql
```

The file `app/Schema/Sql/postgres.sql` is a sql dump that represent the last version of the database.