[github/wallabag/wallabag.git] / INSTALL.md

# Installing poche

Get the [latest twig version](https://github.com/inthepoche/poche/archive/twig.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.

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

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

## updating 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.

That's all, you can use poche !
Commit	Line	Data
1d517de6 NL	1	# Installing poche
	2
	3	Get the [latest twig version](https://github.com/inthepoche/poche/archive/twig.zip) of poche on github. Unzip it and upload it on your server.
	4
	5	your datas can be stored on sqlite, postgres or mysql databases.
	6
	7	Edit /inc/poche/config.inc.php :
	8
	9	```php
	10	define ('STORAGE','sqlite'); # postgres, mysql, sqlite
	11	define ('STORAGE_SERVER', 'localhost'); # leave blank for sqlite
	12	define ('STORAGE_DB', 'poche'); # only for postgres & mysql
	13	define ('STORAGE_SQLITE', './db/poche.sqlite');
	14	define ('STORAGE_USER', 'user'); # leave blank for sqlite
	15	define ('STORAGE_PASSWORD', 'pass'); # leave blank for sqlite
	16	```
	17
	18	poche must have write access on assets, cache and db directories.
	19
	20	[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.
	21
	22	## storage in sqlite
	23	You have to install [sqlite for php](http://www.php.net/manual/en/book.sqlite.php) on your server.
	24
	25	Copy /install/poche.sqlite in /db
	26
	27	## storage in mysql
	28	Execute /install/mysql.sql file in your database.
	29
	30	## storage in postgres
	31	Execute /install/postgres.sql file in your database.
	32
	33	Install composer in your project :
	34	```bash
	35	curl -s http://getcomposer.org/installer \| php
	36	```
	37	Install via composer :
	38	```bash
	39	php composer.phar install
	40	```
	41
	42	## updating from poche 0.3
	43	With poche <= 0.3, all your datas were stored in a sqlite file. The structure of this file changed.
	44
	45	You have to execute http://yourpoche/install/update_sqlite_from_0_to_1.php before using this new version.
	46
	47	That's all, you can use poche !