1
0
mirror of https://github.com/Unleash/unleash.git synced 2024-12-28 00:06:53 +01:00
This commit is contained in:
ivaosthu 2016-12-02 17:47:13 +01:00
parent 291fc10694
commit c3b8ed38f0
3 changed files with 39 additions and 6 deletions

View File

@ -16,6 +16,29 @@ Known client implementations:
- [unleash-client-node](https://github.com/unleash/unleash-client-node) - [unleash-client-node](https://github.com/unleash/unleash-client-node)
- (you implementaiton here!) - (you implementaiton here!)
# Running Unleash
## Requirements
You will need a __PostreSQL__ 9.3+ database instance to be able to run Unleash.
When starting Unleash you must specify a database uri (can be set as environment variable DATABASE_URL)
which includes a username and password, that have rights to migrate the database.
_Unleash_ will, at startup, check whether database migration is needed, and perform necessary migrations.
## Start Unleash
### 1. The simplest way to get started:
```bash
$ npm install unleash-server -g
$ unleash -d postgres://unleash_user:passord@localhost:5432/unleash -p 4242
Unleash started on port:4242
```
You can also require Unleash as a lib and expend it with more options. Read more about this feature in the [getting started guide](./docs/getting-started.md).
## Project details ## Project details
- [Project Roadmap](https://github.com/unleash/unleash/wiki/Roadmap) - [Project Roadmap](https://github.com/unleash/unleash/wiki/Roadmap)

View File

@ -1,6 +1,6 @@
# Developer Guide # Developer Guide
## Postgre ## PostgreSQL
To run and develop unleash you need to have PostgreSQL databse (PostgreSQL v.9.5.x or newer) locally. To run and develop unleash you need to have PostgreSQL databse (PostgreSQL v.9.5.x or newer) locally.

View File

@ -1,12 +1,15 @@
# Getting stated (v.1.0.x) # Getting stated (v.1.0.x)
### Prerequisite ## Requirements
To run unleash you need to provide a PostgreSQL databse (PostgreSQL v.9.5.x or newer).
You need to give unleash a database uri which includes a username and password, that have rights to You will need a __PostreSQL__ 9.3+ database instance to be able to run Unleash.
migrate the database. _Unleash_ will, at startup, check whether database migration is needed,
and perform necessary migrations.
When starting Unleash you must specify a database uri (can be set as environment variable DATABASE_URL)
which includes a username and password, that have rights to migrate the database.
_Unleash_ will, at startup, check whether database migration is needed, and perform necessary migrations.
## Start Unleash
### 1. The simplest way to get started: ### 1. The simplest way to get started:
```bash ```bash
@ -17,6 +20,7 @@ Unleash started on port:4242
``` ```
### 2. Or programmatically: ### 2. Or programmatically:
You can also depend on unleash
```js ```js
const unleash = require('unleash-server'); const unleash = require('unleash-server');
@ -28,3 +32,9 @@ unleash.start({
console.log(`Unleash started on port:${unleash.app.get('port')}`); console.log(`Unleash started on port:${unleash.app.get('port')}`);
}); });
``` ```
Available unleash options includes:
- databaseURI
- port
- logLevel - ('INFO', 'ERROR',)