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

# Installing poche

Get the [latest dev version](https://github.com/inthepoche/poche/archive/dev.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 !
Commit	Line	Data
1d517de6 NL	1	# Installing poche
1d517de6 NL	2
77dea8a2	3	Get the [latest dev version](https://github.com/inthepoche/poche/archive/dev.zip) of poche on github. Unzip it and upload it on your server.
1d517de6 NL	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
145f5040 NL	22	## twig
	23	poche now uses twig for templating. You have to install twig.
	24
	25	Install composer in your project :
	26	```bash
	27	curl -s http://getcomposer.org/installer \| php
	28	```
	29	Install via composer :
	30	```bash
	31	php composer.phar install
	32	```
	33
	34	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).
	35
1d517de6 NL	36	## storage in sqlite
	37	You have to install [sqlite for php](http://www.php.net/manual/en/book.sqlite.php) on your server.
	38
	39	Copy /install/poche.sqlite in /db
	40
	41	## storage in mysql
	42	Execute /install/mysql.sql file in your database.
	43
	44	## storage in postgres
	45	Execute /install/postgres.sql file in your database.
	46
145f5040	47	## upgrading from poche <= 0.3
1d517de6 NL	48	With poche <= 0.3, all your datas were stored in a sqlite file. The structure of this file changed.
	49
	50	You have to execute http://yourpoche/install/update_sqlite_from_0_to_1.php before using this new version.
	51
6e5f8db8 NL	52	## installing poche
6e5f8db8 NL	53	you can go on your poche http://yourpoche. You have to fill the fields and that's all !