47 lines
2.0 KiB
Markdown
47 lines
2.0 KiB
Markdown
|
# Manuel Installation Guide
|
||
|
|
|
||
|
|
**We are assuming that the system user `www-data` will run all processes!**
|
||
|
|
|
||
|
|
### API Setup
|
||
|
|
|
||
|
|
##### Preparation
|
||
|
|
- clone repo to `/var/www/ffplayout`
|
||
|
|
- cd in root folder from repo
|
||
|
|
- add virtual environment: `virtualenv -p python3 venv`
|
||
|
|
- run `source ./venv/bin/activate`
|
||
|
|
- install dependencies: `pip install -r requirements-base.txt`
|
||
|
|
- cd in `ffplayout`
|
||
|
|
- generate secret: `python manage.py shell -c 'from django.core.management import utils; print(utils.get_random_secret_key())'`
|
||
|
|
- open **ffplayout/settings.py**
|
||
|
|
- past secret key in variable `SECRET_KEY`
|
||
|
|
- change `DEBUG = True` to `DEBUG = False`
|
||
|
|
- set `ALLOWED_HOSTS` with correct URL
|
||
|
|
- set URL in `CORS_ORIGIN_WHITELIST`
|
||
|
|
- collect staticfiles: `python manage.py collectstatic`
|
||
|
|
|
||
|
|
##### System Setup
|
||
|
|
- copy **docs/ffplayout-api.service** from root folder to **/etc/systemd/system/**
|
||
|
|
- enable service and start it: `systemctl enable ffplayout-api.service && systemctl start ffplayout-api.service`
|
||
|
|
- install **nginx**
|
||
|
|
- edit **docs/ffplayout.conf**
|
||
|
|
- set correct IP and `server_name`
|
||
|
|
- add domain `http_origin` test value
|
||
|
|
- add https redirection and SSL if is necessary
|
||
|
|
- copy **docs/ffplayout.conf** to **/etc/nginx/sites-available/**
|
||
|
|
- symlink config: `ln -s /etc/nginx/sites-available/ffplayout.conf /etc/nginx/sites-enabled/`
|
||
|
|
- restart nginx
|
||
|
|
- run `visudo` and add:
|
||
|
|
```
|
||
|
|
www-data ALL = NOPASSWD: /bin/systemctl start ffplayout-engine.service, /bin/systemctl stop ffplayout-engine.service, /bin/systemctl reload ffplayout-engine.service, /bin/systemctl restart ffplayout-engine.service, /bin/systemctl status ffplayout-engine.service, /bin/systemctl is-active ffplayout-engine.service, /bin/journalctl -n 1000 -u ffplayout-engine.service
|
||
|
|
```
|
||
|
|
|
||
|
|
### Frontend
|
||
|
|
|
||
|
|
**We need a recent version of npm**
|
||
|
|
|
||
|
|
- go to folder **/var/www/ffplayout/ffplayout/frontend**
|
||
|
|
- install dependencies: `npm install`
|
||
|
|
- build app: `npm run build`
|
||
|
|
|
||
|
|
Your frontend should be now in **/var/www/ffplayout/ffplayout/frontend/dist** folder, which we are included already in the nginx config. You can service now the GUI under your domain URL.
|