updated from INSTALL.md

El RIDO 2016-12-26 10:52:27 +01:00
parent ad4339cde9
commit 636053f1f9

@ -1,8 +1,10 @@
# Installation
**TL;DR:** Download the **TL;DR:** Download the
[latest release archive](https://github.com/PrivateBin/PrivateBin/releases/latest) [latest release archive](https://github.com/PrivateBin/PrivateBin/releases/latest)
and extract it in your web hosts folder where you want to install your PrivateBin and extract it in your web hosts folder where you want to install your PrivateBin
instance. We try to provide a safe default configuration, but we advise you to instance. We try to provide a safe default configuration, but advise you to check
check the options and adjust them as you want. the options and adjust them as you see fit.
## Basic installation ## Basic installation
@ -11,12 +13,14 @@ check the options and adjust them as you want.
- PHP version 5.3 or above - PHP version 5.3 or above
- _one_ of the following sources of cryptographically safe randomness is required: - _one_ of the following sources of cryptographically safe randomness is required:
- PHP 7 or higher - PHP 7 or higher
- [Libsodium](https://download.libsodium.org) - [Libsodium](https://download.libsodium.org/libsodium/content/installation/) and it's [PHP extension](https://paragonie.com/book/pecl-libsodium/read/00-intro.md#installing-libsodium)
- open_basedir access to `/dev/urandom` - open_basedir access to `/dev/urandom`
- mcrypt extension - mcrypt extension
- com_dotnet extension - com_dotnet extension
Mcrypt needs to be able to access `/dev/urandom`. This means if `open_basedir` is set, it must include this file.
- GD extension - GD extension
- some disk space or (optional) a database supported by PDO - (optional) a database supported by [PDO](https://secure.php.net/manual/book.pdo.php)
- ability to create files and folders in the installation directory and the PATH - ability to create files and folders in the installation directory and the PATH
- A web browser with javascript support - A web browser with javascript support
@ -43,7 +47,7 @@ In the index.php you can define a different `PATH`. This is useful to secure you
installation. You can move the configuration, data files, templates and PHP installation. You can move the configuration, data files, templates and PHP
libraries (directories cfg, doc, data, lib, tpl, tst and vendor) outside of your libraries (directories cfg, doc, data, lib, tpl, tst and vendor) outside of your
document root. This new location must still be accessible to your webserver / PHP document root. This new location must still be accessible to your webserver / PHP
process (see also process (see also
[open_basedir setting](https://secure.php.net/manual/en/ini.core.php#ini.open-basedir)). [open_basedir setting](https://secure.php.net/manual/en/ini.core.php#ini.open-basedir)).
> #### PATH Example > #### PATH Example
@ -102,39 +106,32 @@ The table prefix option is called `tbl`.
For reference or if you want to create the table schema for yourself (replace For reference or if you want to create the table schema for yourself (replace
`prefix_` with your own table prefix): `prefix_` with your own table prefix):
```sql CREATE TABLE prefix_paste (
CREATE TABLE prefix_paste ( dataid CHAR(16) NOT NULL,
dataid CHAR(16) NOT NULL, data BLOB,
data BLOB, postdate INT,
postdate INT, expiredate INT,
expiredate INT, opendiscussion INT,
opendiscussion INT, burnafterreading INT,
burnafterreading INT, meta TEXT,
meta TEXT, attachment MEDIUMBLOB,
attachment MEDIUMBLOB, attachmentname BLOB,
attachmentname BLOB, PRIMARY KEY (dataid)
PRIMARY KEY (dataid) );
);
CREATE TABLE prefix_comment (
CREATE TABLE prefix_comment ( dataid CHAR(16),
dataid CHAR(16), pasteid CHAR(16),
pasteid CHAR(16), parentid CHAR(16),
parentid CHAR(16), data BLOB,
data BLOB, nickname BLOB,
nickname BLOB, vizhash BLOB,
vizhash BLOB, postdate INT,
postdate INT, PRIMARY KEY (dataid)
PRIMARY KEY (dataid) );
); CREATE INDEX parent ON prefix_comment(pasteid);
CREATE INDEX parent ON prefix_comment(pasteid);
CREATE TABLE prefix_config (
CREATE TABLE prefix_config ( id CHAR(16) NOT NULL, value TEXT, PRIMARY KEY (id)
id CHAR(16) NOT NULL, value TEXT, PRIMARY KEY (id) );
); INSERT INTO prefix_config VALUES('VERSION', '1.1');
INSERT INTO prefix_config VALUES('VERSION', '0.22');
```
## Further configuration
- After (or before) setting up PrivateBin set up HTTPS, as without HTTPS PrivateBin is not secure. ([More information](https://github.com/PrivateBin/PrivateBin/wiki/FAQ#how-should-i-setup-https))
- If you want to use PrivateBin behind Cloudflare, make sure you disabled Rocket loader and unchecked "Javascript" for Auto Minify, found in your domain settings, under "Speed". (More information [in this FAQ entry](https://github.com/PrivateBin/PrivateBin/wiki/FAQ#user-content-how-to-make-privatebin-work-when-using-cloudflare-for-ddos-protection))