INSTALLATION.md 1.71 KB
Newer Older
1
# How to install Qowala
Killian Kemps's avatar
Killian Kemps committed
2

3
## Qowala configuration
Killian Kemps's avatar
Killian Kemps committed
4 5 6 7 8 9 10 11
- Copy and rename **config/template_twitter.json** to **config/twitter.json** and put in your Twitter credentials (you can get the credentials on *Twitter Developer Website* at http://apps.twitter.com after creating your own app).

- Give your application Read & Write permissions on Twitter Application Management Dashboard

![Twitter App Manager](http://www.killiankemps.fr/data/images/qowala-live-twitter-settings.png)

- For the callback URL in **config/twitter.json** you have to put the domain name where the app will be hosted and add to it '/auth/twitter/callback'.

12
## Qowala easy installation
Killian Kemps's avatar
Killian Kemps committed
13

14
Just launch the **Qowala_InstallationScript.sh**, it will do automatically what is below
Killian Kemps's avatar
Killian Kemps committed
15

16
## Qowala manual installation
Killian Kemps's avatar
Killian Kemps committed
17

18
### Ubuntu 14.04 process:
Killian Kemps's avatar
Killian Kemps committed
19

20
#### Install NodeJS
Killian Kemps's avatar
Killian Kemps committed
21 22 23 24
    curl -sL https://deb.nodesource.com/setup | sudo bash -
    sudo apt-get install nodejs
    sudo apt-get install build-essential

25
#### Install MongoDB
Killian Kemps's avatar
Killian Kemps committed
26 27 28 29 30
    sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 7F0CEB10
    echo 'deb http://downloads-distro.mongodb.org/repo/ubuntu-upstart dist 10gen' | sudo tee /etc/apt/sources.list.d/mongodb.list
    sudo apt-get update
    sudo apt-get install -y mongodb-org

31
#### Install the dependencies
Killian Kemps's avatar
Killian Kemps committed
32 33 34 35 36 37
    npm install

*NodeJS installation process inspired by Digital Ocean: https://www.digitalocean.com/community/tutorials/how-to-install-node-js-on-an-ubuntu-14-04-server*

*MongoDB installation process inspired by MongoDB.org http://docs.mongodb.org/manual/tutorial/install-mongodb-on-ubuntu/*

38
## Qowala Simple Run
Killian Kemps's avatar
Killian Kemps committed
39 40
    nodejs server.js

41
## Qowala Production mode
Killian Kemps's avatar
Killian Kemps committed
42 43
    sudo npm install -g forever
    forever -l forever.log -ao stdout.log -e stderr.log start server.js