Varken/README.md

49 lines
1.9 KiB
Markdown
Raw Normal View History

2018-12-01 21:15:12 -08:00
# Varken
[![Discord](https://img.shields.io/badge/Discord-Varken-7289DA.svg?logo=discord&style=flat-square)](https://discord.gg/AGTG44H)
[![BuyMeACoffee](https://img.shields.io/badge/BuyMeACoffee-Donate-ff813f.svg?logo=CoffeeScript&style=flat-square)](https://www.buymeacoffee.com/varken)
[![Docker Pulls](https://img.shields.io/docker/pulls/boerderij/varken.svg?style=flat-square)](https://hub.docker.com/r/boerderij/varken/)
2018-12-01 21:47:59 -08:00
Dutch for PIG. PIG is an Acronym for Plex/InfluxDB/Grafana
2018-12-01 21:15:12 -08:00
varken is a standalone command-line utility to aggregate data
2018-12-04 08:50:02 -08:00
from the Plex ecosystem into InfluxDB. Examples use Grafana for a
2018-12-03 21:47:46 -08:00
frontend
Requirements:
* Python3.6+
* Python3-pip
2018-12-04 08:03:39 -08:00
<p align="center">
<img width="800" src="https://i.imgur.com/av8e0HP.png">
</p>
2018-10-29 17:16:31 -07:00
## Quick Setup
2018-12-05 07:33:36 -08:00
1. Clone the repository `sudo git clone https://github.com/Boerderij/Varken.git /opt/Varken`
2018-12-04 08:03:39 -08:00
1. Follow the systemd install instructions located in `varken.systemd`
2018-12-05 10:59:22 -08:00
1. Create venv in project `cd /opt/Varken && /usr/bin/python3 -m venv varken-venv`
2018-12-05 07:33:36 -08:00
1. Install requirements `/opt/Varken/varken-venv/bin/python -m pip install -r requirements.txt`
2018-12-04 08:03:39 -08:00
1. Make a copy of `varken.example.ini` to `varken.ini` in the `data` folder
2018-12-05 07:33:36 -08:00
`cp /opt/Varken/data/varken.example.ini /opt/Varken/data/varken.ini`
2018-12-04 08:03:39 -08:00
1. Make the appropriate changes to `varken.ini`
2018-12-05 07:33:36 -08:00
ie.`nano /opt/Varken/data/varken.ini`
2018-12-05 10:59:22 -08:00
1. Make sure all the files have the appropriate permissions `sudo chown varken:varken -R /opt/Varken`
2018-12-04 08:03:39 -08:00
1. After completing the [getting started](http://docs.grafana.org/guides/getting_started/) portion of grafana, create your datasource for influxdb.
1. Install `grafana-cli plugins install grafana-worldmap-panel`
2018-08-06 10:41:31 -07:00
2018-12-03 12:37:29 -08:00
### Docker
Repo is included in [Boerderij/docker-Varken](https://github.com/Boerderij/docker-Varken)
2018-12-03 12:37:29 -08:00
<details><summary>Example</summary>
<p>
```
docker run -d \
--name=varken \
-v <path to data>:/config \
2018-12-03 12:37:29 -08:00
-e PGID=<gid> -e PUID=<uid> \
boerderij/varken:nightly
2018-12-03 12:37:29 -08:00
```
</p>
2018-12-04 08:03:39 -08:00
</details>