Merge pull request #99 from gled-rs/feature/install_instructions

Feature/install instructions
This commit is contained in:
Baptiste Gelez 2018-06-29 12:11:04 +02:00 committed by GitHub
commit 6b1c68b89e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 45 additions and 0 deletions

45
INSTALL.md Normal file
View File

@ -0,0 +1,45 @@
# How to install Plume on a Debian stretch:
## Basic setup:
apt update
apt install gettext postgresql postgresql-contrib libpq-dev
adduser plume
su - plume
cd /home/plume
git clone https://github.com/Plume-org/Plume.git
curl https://sh.rustup.rs -sSf | sh -s -- --no-modify-path --default-toolchain nightly
cd Plume
rustup toolchain install nightly
rustup override set nightly-2018-05-15 # this seems to be needed for compilation
cargo install diesel_cli --no-default-features --features postgres # we dont need to compile anything else than pgsql
## Now, if you want to run postgresql on the same server:
cargo run # this will configure and launch Plume on the server.
## If you want to run Plume with a remote DB this time ( Postgresql is not installed on the same server/container):
* On the DB server:
service postgresql start
su - postgres
createuser -d -P plume
createdb -O plume plume
* On the Plume server:
cd /home/plume/Plume
diesel migration run --database-url postgres://plume:PASSWORD@DBSERVERIP:DBPORT/plume
DB_URL=postgres://plume:PASSWORD@DBSERVERIP:DBPORT/plume cargo run # the first launch will ask questions to configure the instance. A second launch will not need the DB_URL.
## Plume is now accessible as seen on your console. You can have fun now, or configure an nginx proxy with the following excerpt:
location / {
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $http_host;
proxy_pass http://localhost:8000;
client_max_body_size 16m;
}
# Caveats:
* Pgbouncer is not yet supported ( named transactions are used ).