wallabag/INSTALL.md

# Installing poche

Get the [latest version](https://github.com/inthepoche/poche/archive/1.0-beta1.zip) of poche on github. Unzip it and upload it on your server.

your datas can be stored on sqlite, postgres or mysql databases.

Edit /inc/poche/config.inc.php :

```php
define ('STORAGE','sqlite'); # postgres, mysql, sqlite
define ('STORAGE_SERVER', 'localhost'); # leave blank for sqlite
define ('STORAGE_DB', 'poche'); # only for postgres & mysql
define ('STORAGE_SQLITE', './db/poche.sqlite');
define ('STORAGE_USER', 'user'); # leave blank for sqlite
define ('STORAGE_PASSWORD', 'pass'); # leave blank for sqlite
```

poche must have write access on assets, cache and db directories.

[PHP cURL](http://www.php.net/manual/en/book.curl.php) & [tidy_parse_string](http://www.php.net/manual/en/tidy.parsestring.php) are recommended.

## twig
poche now uses twig for templating. You have to install twig. 

Install composer in your project : 
```bash
curl -s http://getcomposer.org/installer | php
```
Install via composer : 
```bash
php composer.phar install
```

If you don't want to install twig by yourself, you can download [this file](http://static.inthepoche.com/files/poche-1.0-latest-with-twig.zip).

## storage in sqlite 
You have to install [sqlite for php](http://www.php.net/manual/en/book.sqlite.php) on your server.

Copy /install/poche.sqlite in /db

## storage in mysql
Execute /install/mysql.sql file in your database.

## storage in postgres 
Execute /install/postgres.sql file in your database.

## upgrading from poche <= 0.3
With poche <= 0.3, all your datas were stored in a sqlite file. The structure of this file changed. 

You have to execute http://yourpoche/install/update_sqlite_from_0_to_1.php before using this new version.

## installing poche
you can go on your poche http://yourpoche. You have to fill the fields and that's all !